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Benvenuti nel mondo dei programmatori. 

Avete fatto una buona scelta! In questa nuova rivista 
infatti troverete i principi della programmazione. 

La maggior parte della rivista è dedicata a un 
assemblatore che vi permetterà di "trafficare" 
nella maniera migliore e più semplice. 

Il primo "tool" di lavoro è comunque una tavoletta 
grafica che vi darà la possibilità di disegnare 
a vostro piacimento. Poi troverete un Editor di sprite 
e uno di caratteri. Quindi non potevamo non darvi due 
copiatori, uno di programmi (files) e uno di dischi interi. 
Infine oltre all’Assemblatore di cui vi abbiamo già detto, 
c'è un comodissimo allineatore di testina del vostro 
disk drive che vi farà risparmiare tempo e soldi. 
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TAVOLETTA GRAFICA 



EDITOR SPRITES 


Usa il joystick in porta 2 oppure: 


FI = T F3 = 1 F5 = 

*— 

F7 = -* 

Spazio = Fuoco 

HEX 

DEC 

lnizl ° pagina 

6000 

24576 

Fine 9 ra,ica 

7F3F 

32575 

lnlzi0 colore 

8328 

33576 

Fine N - 1 

870F 

34575 


,nizio colore 

Pina N. 2 


Valore da 
Trasferire 
In D021 

flLt -'àXO 


7F40 

32576 

8327 

33575 

8710 

34576 


L per caricare un file di dati 
S per salvare un file di dati 
D per stampare sul video i dati delle sprite se¬ 
lezionate. 

+ per sovrapporre alla sprite visualizzata 
un'altra sprite 

HOME per portare il cursore in alto a sinistra 
CLR per cancellare la sprite visualizzata 
P per visualizzare una sprite precedente 
• per accendere il punto sotto il cursore 
F per "riempire’’ la sprite visualizzata 
G per puntare ad un’altra sprite 
X per abortire "sprite maker" 


C per copiare una sprite 
N per puntare alla sprite successiva 
M per passare in "multicolor mode" 

H per passare in "High-Resolution Mode" 
<SPACE> per cancellare un punto puntato 
Cursori per puntare un punto 
FI per cambiare il colore di tondo 
F3 per cambiare il colore N. 1 
F5 per cambiare il colore N. 2 
F7 per cambiare il colore principale 
Dati Tecnici HEX DEC 

Inizio File 3200 12800 

Fine File 3FFF 16383 
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EDITOR CARATTERI 



E ERASE per cancellare un blocco di caratteri 
< SCRSIN scroll finestra a sinistra 
> SCRDES scroll finestra a destra 
O SCRSU scroll finestra in alto 
L SCRGIU scroll finestra in basso 
X MAPPA per variare la mappa caratteri 

(tasto CLR-Home + Shift) clear pulisce finestra 
F FILL riempie finestra 
C COPY RAM copia un blocco di caratteri 
Y COPY ROM copia un blocco di caratteri prele¬ 
vandoli dal set standard 
N NEXT punta al carattere successivo 
P PREVIOUS punta al carattere precedente 
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G GOTO punta al carattere che viene scelto 
t HOME il cursore nella finestra va in alto a sin. 
M MULTI passa in multicolor mode 
H HIRES passa in alta risoluzione 
2 MEMORIZZA memorizza un carattere 
V RISCRIVE riscrive un carattere 
Q OUIT torna al basic lasciando lo split del video 
1,283 COLORI cambiano i colori: caratteri, multi 
1 , multi 2 

S SAVE salva un set su disco 
A LOAD carica un set su disco 
F8 SCRIVE scrive un carattere editato 
FI MATRICE legge un carattere da editare 




























COPIA DISCHI 


Questo programma serve per effettuare il back- 
up completo di un disco. La sua originalità sta 
nel fatto che il programma chiede ed esegue 
tutto ciò che noi gli vogliamo far tare. Ad esem¬ 
pio si può indicare e copiare solo le tracce che 
noi desideriamo guadagnando in tempo e spa¬ 
zio sul dischetto. 



COPIA PROGRAMMI 


È forse uno dei copiatori più utili che i program¬ 
matori del 64 abbiano pensato. Infatti in un so¬ 
lo programma, senza bisogno di trafficare con 
dischetti e programmi vari, si può copiare un 
programma, vedere la directory del disco, in¬ 
serire i comandi di lavoro, analizzare lo status 
del dischetto e uscire dal programma. 

FI copia il file 
F3 dà la directory 
F5 comandi disco 
F7 status disco 
F8 esce dal programma 
SPAZIO torna al menu 




Un semplice e breve programma che vi fa ri¬ 
sparmiare un sacco di tempo e permette di 
avere sempre la testina del drive nella giusta 
posizione. Dopo aver caricato II programma bi¬ 
sogna attendere affinché la testina si posizio¬ 
ni correttamente e il tempo di accesso al disco 
sia inferiore a 9. Comunque il programma vi 
indica chiaramente sul video le operazioni che 
il drive sta svolgendo. 









ASSEMBLATORE 


Questo manuale descrive il linguaggio assem¬ 
bler e le procedure per assemblare program¬ 
mi per il Commodore 64 che usino uno dei 
processori della serie 6500. In commercio esi¬ 
stono numerosi assembler per lo sviluppo di 
programmi con la serie 6500, ed ognuno ha 
delle modalità di utilizzo leggermente diverse, 
pur mantenendo le medesime linee generali. La 
serie di processori 6500 comprende tutti quelli 
dal 6502 al 6515 (il set di istruzioni è identico). 
Il processo di traduzione di un programma dalla 
forma mnemonica o simbolica al vero codice 
macchina è chiamato assemblaggio o compi¬ 
lazione (d'ora in poi questi termini verranno usa¬ 
ti indifferentemente), e un programma che 
effettui questa traduzione è detto assembler. 
Noi chiameremo CODICE SORGENTE la for¬ 
ma simbolica di un programma, CODICE OG¬ 
GETTO il vero codice macchina costituente il 
programma stesso. Generalmente un coman¬ 
do in linguaggio assembler viene tradotto in una 
singola istruzione in codice macchina; questo 
distingue un assembler da un compilatore ad 
alto livello, in quanto quest'ultimo può genera¬ 
re più istruzioni da una sola. Un assembler che 
opera su di un computer diverso da quello per 
cui il codice è generato è chiamato cross- 
assembler. Spesso l'uso di un cross-assembler 
si rende necessario perché un computer non 
ha sufficiente potenza per gestire un buon as¬ 
sembler, ma nel caso del Commodore 64 non 
ci sono tali problemi: con un floppy disk ed una 
stampante il sistema è adatto allo sviluppo di 
software. 

Solitamente i computer digitali usano la nume¬ 
razione binarla per rappresentare dati ed istru¬ 
zioni, in quanto possono gestire solo 'uno' e 
'zero', corrispondenti agli stati acceso e spen¬ 
to. Per gli uomini, d'altra parte, è molto difficile 
lavorare con la numerazione binaria, quindi si 
usano delle numerazioni più convenienti, in ba¬ 
se 8 (ottale), in base 10 (decimale) ed in base 
16 (esadecimale). Due rappresentazioni dell'o¬ 
perazione di caricamento di un valore nell'ac¬ 
cumulatore sono: 

10101001 (binario) 

A9 (esadecimale) 

Un'istruzione per porre il valore 21 (decimale) 
nell'accumulatore è: 

A9 15 (esadecimale) 

La rappresentazione numerica delle istruzioni 
è comunque piuttosto difficile da ricordare, per 


questo sono state inserite delle rappresentazio¬ 
ni simboliche con le quali è molto più semplice 
lavorare. Per esempio l’istruzione precedente 
potrebbe essere scritta così: 

LDA #21 

In questo esempio LDA è la rappresentazione 
simbolica per A9, e significa 'carica l’accumu¬ 
latore' (in inglese LoaD thè Accumulator). Un 
assembler può trasformare la scrittura simboli¬ 
ca LDA nella forma numerica A9. 

Ogni istruzione in codice macchina ha un pro¬ 
prio nome simbolico chiamato CODIFICA. La 
codilica per 'salva l'accumulatore’ è STA. La 
codifica per 'trasferisci l'accumulatore al regi¬ 
stro X’ è TAX. Le 56 codifiche proprie della se¬ 
rie di processori 6500 sono elencate nella 
Appendice IV. Un'istruzione in linguaggio as¬ 
sembler consiste in una codifica, seguita talvol¬ 
ta da un operando, che specifica il dato su cui 
agisce l'operazione. 

Un'etichetta è un 'nome' per una linea di pro¬ 
gramma; può essere apposta per creare un ri¬ 
ferimento ad uso di altre istruzioni, come si può 
vedere: 

L2 LDA #12 

L'etichetta è L2, la codifica è LDA e l'operan¬ 
do è #12. Almeno uno spazio deve separare 
le tre parti (campi) di un'istruzione, e gli spazi 
addizionali che possono essere aggiunti per fa¬ 
cilitare la lettura da parte del programmatore 
vengono ignorati dall'assembler. 

Le istruzioni per la serie di processori 6500 han¬ 
no al massimo un operando, ed alcune ne so¬ 
no del tutto prive. In questi casi l’operazione 
che va eseguita è totalmente specificata dalla 
codifica, come ad es. CLC (azzera il flag di car- 
ry o riporto). 

Programmare in linguaggio assembler richie¬ 
de l'apprendimento del set di istruzioni (codifi¬ 
che), delle convenzioni di indirizzamento per il 
riferimento ai dati, delle strutture dei dati all'in¬ 
terno del processore, e naturalmente della strut¬ 
tura dei programmi in linguaggio assembler. 
Parte terza. 'Creare e modificare file sorgenti 
in linguaggio assembler', è composta dalle se¬ 
zioni 5-6, e descrive come creare e modificare 
un file sorgente in linguaggio assembler. La se¬ 
zione 5 contiene le istruzioni per caricare un 
programma di supporto, il programma WEDGE. 
Questo programma fornisce all’utente dei co¬ 
mandi addizionali per utilizzare il disco, carica¬ 
re ed eseguire programmi. La sezione 6 con- 
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tiene le istruzioni operative per caricare ed ese¬ 
guire il programma EDITOR 64, che permette 
di creare e modificare file sorgenti in assembler. 
Parte quarta. 'Assemblare e controllare un pro¬ 
gramma'. è composta dalle sezioni 7-9, e con¬ 
tiene informazioni sul programma che permette 
all’utente di assemblare, controllare ed even¬ 
tualmente correggere un programma oggetto. 
La sezione 7 descrive le operazioni del pro¬ 
gramma assembler; la sezione 8 descrive il pro¬ 
gramma che deve essere usato per caricare un 
programma oggetto in memoria; la sezione 9 
descrive il programma che permette di esami¬ 
nare la memoria per correggere gli errori 
(monitor). 

Parte quinta. 'Appendici', contiene quelle ta¬ 
belle che possono essere usate come riferimen¬ 
to ad altre sezioni. Fornisce anche un 
riferimento rapido ai comandi disponibili quan¬ 
do si eseguono alcuni programmi. 

In questo manuale ci sono alcune convenzioni 
atte a rendere più chiare le spiegazioni. Ecco¬ 
ne l'elenco: 

< ) 

Sono usate per indicare che l’argomento in es¬ 
se racchiuso è opzionale. Le sole eccezioni a 
questa regola sono in quelle sezioni dove so¬ 
no spiegati l'indirizzamento indiretto indicizza¬ 
to e l'indirizzamento indicizzato indiretto. In 
questi casi le parentesi sono necessarie. 

Etichetta 

È usato per indicare un riferimento ad un'eti¬ 
chetta nel codice sorgente di un programma. 
La vera etichetta usata è determinata dal pro¬ 
grammatore. 

Codifica 

È usato per indicare una delle istruzioni del 
6502 elencate nella Appendice IV. 

Operando 

È usato per indicare l'operando o l'argomento 
di un'istruzione. 

Nomefile 

È usato per specificare il nome di un file su di¬ 
sco. Il vero nome è determinato dall'utente. 

Nomefile* 

È usato per indicare il nome di più file (ovvero 
un nome che finisca con ’*'). 

Variabile min. 

Generalmente le variabili in minuscolo indica¬ 
no che è compito dell’utente specificare quel 
dato. 

Nome Maiuscolo 

Generalmente i nomi in maiuscolo indicano l'in¬ 
put da battere. 


1.0 Convenzioni sijl formato delle istruzioni 

Le istruzioni per l'assembler del Commodore 
64 si dividono in due tipi fondamentali: 

* istruzioni di linguaggio macchina 

* comandi per l'assembler 

Le istruzioni di linguaggio macchina sono le 56 
operazioni implementate sulla serie di proces¬ 
sori 6500. Il formato delle istruzioni è: 
(etichetta) codifica (operando) (commento) 

I campi chiusi tra parentesi sono opzionali, ov¬ 
vero possono essere usati oppure omessi a di¬ 
screzione dell’utente. 

Etichette e commenti sono sempre opzionali, 
e molte codifiche come RTS (ritorna da una su¬ 
broutine) non richiedono operando. Una linea 
può anche contenere solo un'etichetta o un 
commento. 

Una tipica istruzione che mostra tutti e quattro 
i campi è: 

LOOP LDA BETA, X ; 

PRENDI BETA INDICIZZATO DA X 
Un campo è definito come una stringa di ca¬ 
ratteri separati da uno spazio. Un'etichetta é 
una stringa alfanumerica da uno a sei caratte¬ 
ri, il primo dei quali deve essere una lettera. 
Un'etichetta non può essere nessuna delle 56 
codifiche, né uno dei caratteri speciali usati dal- 
l'assembler come riferimento a: 

Accumulatore (A) 

Puntatore dello stack (S) 

Stato del processore (P) 

Registri Indice (X e Y) 

Un'etichetta può iniziare in qualsiasi colonna 
sempreché sla il primo campo di un’istruzione. 
Le etichette sono usate nelle istruzioni come 
identificatori di una linea, nelle dichiarazioni di 
dati come riferimento per gli operandi. 
L'operando di un’istruzione specifica o un in¬ 
dirizzo o un valore. 

Un indirizzo può essere calcolato tramite il va¬ 
lore di un’espressione, e l'assembler permette 
una notevole flessibilità nella formazione di 
espressioni. Un'espressione in linguaggio as¬ 
sembler consiste in una stringa di nomi e co¬ 
stanti (che d'ora in poi chiameremo anche 
simboli) separati dai segni operativi +, —, *, 
/ (addizione, sottrazione, moltiplicazione e di¬ 
visione). 

Le espressioni sono valutate dall'assembler per 
calcolare l'indirizzo dell'operando. Le espres¬ 
sioni sono calcolate da destra a sinistra senza 
alcuna precedenza tra i segni operativi e sen¬ 
za considerare le parentesi. 

Ricordate che le espressioni vengono calcola¬ 
te al momento della compilazione e non men¬ 
tre il programma viene eseguito. 
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Qualsiasi stringa di caratteri che segua il cam¬ 
po degli operandi è considerata un commen¬ 
to. I commenti sono listati nel codice sorgente, 
ma vengono ignorati dall'assembler. Se il pri¬ 
mo carattere di una riga è un punto e virgola 
tutto ciò che segue è considerato un commen¬ 
to. In un’istruzione che non richiede operando 
un commento può seguire la codifica, separa¬ 
to da questa mediante almeno uno spazio. 
L'appendice V mostra il listato del codice sor¬ 
gente di un semplice programma. Sono inclu¬ 
si vari esempi di (ormato delle istruzioni. 

1.1 SIMBOLICO 

Forse il più comune modo di indirizzamento de¬ 
gli operandi è la forma simbolica, come in: 
LDA BETA ; METTI IL VALORE BETA 
NELL'ACCUMULATORE 
In questo esempio BETA è un'etichetta che si 
riferisce ad un byte nella memoria contenente 
il valore da caricare nell’accumulatore. BETA 
è un’etichetta o un indirizzo al quale il valore 
si trova. Similmente nell’istruzione: 

LDA ALFA + BETA 

l'indirizzo ALFA + BETA è calcolato dall'as- 
sembler, ed il valore all'Indirizzo di memoria è 
posto nell’accumulatore. 

La memoria associata alla serie di processori 
6500 è segmentata in pagine lunghe 256 byte 
ciascuna. La prima pagina, pagina zero, è trat¬ 
tata dall'assembler e dal processore in modo 
differente rispetto alle altre, per l'ottimizzazio¬ 
ne dello spazio in memoria. Molte delle istru¬ 
zioni hanno codici operativi alternativi se 
l’indirizzo dell’operando è nella pagina zero. In 
questi casi l'indirizzo è lungo un solo byte in¬ 
vece dei normali due. Per esempio: 

LDA BETA 

Se BETA è posto al byte 4B nella pagina ze¬ 
ro, allora il codice generato è A5 B4. Questo 
è chiamato indirizzamento in pagina zero. Se 
BETA è al byte 01 3C nella pagina di memo¬ 
ria uno, il codice generato è AD 3C 01. 
Questo è un esempio di indirizzamento 'as¬ 
soluto'. 

Così, per ottimizzare la quantità di memoria 
utilizzata ed il tempo di esecuzione, un buon 
programmatore dovrebbe progettare pro¬ 
grammi i cui dati risiedano nella pagina zero, 
^quando ciò è possibile. 

Bisogna invece evitare di assemblare pro¬ 
grammi nella pagina zero, poiché potrebbe¬ 
ro sorgere alcuni problemi. 

Ricorda, l'assembler decide che formato usa¬ 
re in base al calcolo dell'Indirizzo dell'o¬ 
perando. 


1.2 Costanti 

I valori costanti in linguaggio assembler pos¬ 
sono avere più formati. Se una costante non 
è decimale, si usa un carattere di prefisso per 
specificarne il tipo: 

$ specifica che il vafore che segue è esade- 
cimale 

©specifica che il valore che segue è ottale 
% specifica che il valore che segue è binario 
’ specifica che bisogna considerare il valore 
ASCII del carattere che segue. 

L'assenza di un prefisso indica che il valore 
è decimale. 

Nel comando: 

LDA BETA + 5 

il numero decimale 5 è sommato a BETA per 
calcolare l'indirizzo. Similmente: 

LDA BETA + $5F 

fa si che il valore esadecimale 5F sia somma¬ 
to a BETA per calcolare l’Indirizzo. 

II modo di indirizzamento immediato è indica¬ 
to dal simbolo ' #' seguito da una costante. 
Per esempio: 

LDA #2 

fa si che il valore decimale 2 sia posto nell'ac¬ 
cumulatore. Similmente: 

LDA it’G 

carica il valore ASCII di ’G’ nell’accumulatore. 
Giacché l'accumulatore è lungo un solo by¬ 
te, il valore caricato deve essere compreso tra 
0 e 255 decimali. 

Il modo di indirizzamento immediato genera 
due o tre byte di codice (dipende se l’indiriz¬ 
zo si trova nella pagina zero oppure no), ov¬ 
vero la codifica ed il valore da usare come 
operando. Nota che le costanti possono es¬ 
sere usate sia nelle espressioni di indirizzo sia 
come valori nel modo di indirizzamento imme¬ 
diato. Possono anche essere usate per inizia- 
lizzare delle locazioni di memoria, come è 
spiegato più avanti. 

1.3 Salti relativi 

Sono disponibili otto istruzioni di salto condi¬ 
zionale. in questo esempio: 

BEO START ; SE UGUALE VAI A START 
Se i valori confrontati sono uguali, l'esecuzio¬ 
ne del programma salta alla linea avente eti¬ 
chetta START. L'indirizzo di salto relativo è 
un numero da —128 a +127, che viene som¬ 
mato (algebricamente) al contatore di pro¬ 
gramma durante l’esecuzione. Quando viene 
eseguita questa addizione il contatore di pro¬ 
gramma punta all'Istruzione successiva all'i¬ 
struzione di salto, li salto parte dalla locazione 
dell'istruzione successiva. Durante la compi- 




lazione viene evidenziato un errore se il salto 
è fuori dai limiti consentiti (ovvero se l'istru¬ 
zione a cui II programma dovrebbe saltare è 
troppo lontana dall’istruzione di salto). 
L’indlrlzzamento relativo è usato esclusiva- 
mente nelle istruzioni di salto. 

1.4 Istruzioni con operando Implicito 

Venticinque istruzioni come TAX (trasferisci 
l'accumulatore ai registro X), non richiedono 
alcun operando, occupando, in questo modo, 
un solo byte. In queste istruzioni infatti l’ope¬ 
rando è implicito nella codifica. 

Quattro istruzioni (ASL, LSR, ROLe ROR) so¬ 
no particolari in quanto in esse l’accumulato¬ 
re. A, può essere usato come operando. In 
questo speciale caso esse sono trattate co¬ 
me indirizzamenti in modo implicito, e viene 
generata una sola codifica. 

1.5 Indirizzamento indiretto indicizzato 

In questo modo, l'indirizzo dell'operando è 
calcolato sommando il registro X (l'indice) al¬ 
l’argomento dell'operando (nell'esempio se¬ 
guente, BETA). Il valore risultante è l'indirizzo 
delle locazioni di pagina zero che contengo¬ 
no l’effettivo indirizzo dell'operando. In que¬ 
sto esempio:. 

LDA (BETA, X) 

le parentesi attorno all’operando indicano il 
modo indiretto. Nell'esempio sopra il valore 
del registro indice X è sommato a BETA; la 
somma si riferisce in ogni caso ad una loca¬ 
zione della pagina zero, in quanto durante l’e¬ 
secuzione il byte alto viene ignorato. I due 
byte a partire da quella locazione sono assunti 
come indirizzo dell’operando, nel formato by¬ 
te basso-byte alto. 

Per capire meglio, considera ciò che segue: 
BETA contiene S12 
X contiene $4 

le locazioni $0017 e $0016 contengono $01 
e $25 

La locazione $0125 contiene $37 
BETA + X è uguale a $16, l'indirizzo alla lo¬ 
cazione $16 è $0125. Il valore a $0125 è $37, 
quindi l'istruzione LDA (BETA, X) carica il va¬ 
lore $37 nell'accumulatore. 

L'indirizzamento indiretto indicizzato è usato 
spesso per accedere ad una tabella di vettori 
di indirizzo posta nella pagina zero. 

La figura seguente illustra questa forma di in¬ 
dirizzamento. 

1.6 Indirizzamento indicizzato indiretto 

Un altro modo di indirizzamento usa il regi¬ 


stro Y ed è illustrato da: 

LDA (GAMMA. Y)' 

In questo caso GAMMA si riferisce alla loca¬ 
zione di pagina zero nella quale si trova un 
indirizzo. Il valore di Y è sommato a quell’in¬ 
dirizzo per calcolare l’effettivo indirizzo del¬ 
l'operando. Considera ciò che segue: 
GAMMA contiene $38 
Y contiene $7 

Le locazioni $0039 e $0038 contengono $00 
e $54 

La locazione 5005B contiene $26 
L'indirizzo a $38 è $0054, ad esso viene som¬ 
mato $7, ottenendo cosi un indirizzo effettivo 
uguale a $005B. Il valore a $005B è S26, che 
viene caricato nell’accumulatore. 

Nel mòdo indicizzato indiretto, l’indice X è 
sommato all'operando prima dell'indirizza- 
mento; nel modo indiretto indicizzato, al con¬ 
trario, prima è effettuato l’indirizzamento, poi 
l'Indice Y è sommato per calcolare l'indirizzo 
effettivo. Il modo indiretto è sempre indiciz¬ 
zato tranne che nell'istruzione JMP, che per¬ 
mette un indirizzamento indiretto assoluto, 
come esemplificato da JMP (DELTA), che 
causa un salto all’indirizzo contenuto nelle lo¬ 
cazioni DELTA e DELTA + 1. 

2.0 Comandi per l'assembier 

Sono disponibili undici comandi riservati al- 
V assembler, usati per riservare aree di memo¬ 
ria, per fornire informazioni direttamente 
all'assembler e per 'dargli ordini', se cosi si 
può dire. Nove di essi hanno nomi simbolici 
il cui primo carattere è un punto. Il decimo, 
il segno di uguale ( = ), stabilisce un'identità 
fra un'espressione ed un valore. L'undicesi¬ 
mo, l’asterisco (•), rappresenta il valore del 
contatore della locazione corrente. Esempi di 
identità sono: ROSSO = 5, BLU = SFF e * 
= 200. Un elenco dei comandi è stampato qui 
sotto (il loro uso è spiegato nella sezione se¬ 
guente). 

BYTE .WORD .DBYTE .PAGE .SKIP 
.OPT .END .FILE .LIB 


Le etichette e tutte le espressioni che non sia¬ 
no comandi non possono iniziare con un 
punto. 

Esempi di comandi all'assembler possono es¬ 
sere visti nel semplice programma assembler 
listato nell'Appendice V. 

Se lo si desidera, si possono abbreviare i co- 
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mandi che cominciano con un punto, batten¬ 
do solo il punto seguito dai primi tre caratteri 
(ad es. '.DBY' invece di '.DBYTE'). 

.BYTE è usato per riservare un byte di me¬ 
moria e per immagazzinare in esso un valo¬ 
re. Il comando può contenere operandi 
multipli, che porranno più valori in byte con¬ 
secutivi. Stringhe ASCII possono essere ge¬ 
nerate racchiudendole tra virgolette semplici 
('), Va ricordato che esiste un limite di 40 ca¬ 
ratteri per ogni comando BYTE. 

QUI BYTE 2 

QUO .BYTE 1,$F,@3, %101.7 

QUA BYTE ’ABCDEFGH' 

Nota che i numeri possono essere scritti nel¬ 
la forma più comoda; in generale ogni espres¬ 
sione, la cui soluzione sia un numero 
compreso tra 0 e 255 (un byte), può essere 
usata in questi comandi. Se vuoi includere 
una virgoletta in una stringa ASCII, inserisci 
due virgolette nella stringa stessa. 

Per esempio; 

.BYTE 'MOLLA L' 'OSSO' 

può essere usato per memorizzare: 

MOLLA L'OSSO 

Bisogna notare che l'uso di operazioni aritme¬ 
tiche nel comando .BYTE non è supportato 
in questa versione del programma. 

.WORD è usato per riservare e caricare due 
byte di dati per volta. Ogni espressione vali¬ 
da, tranne le stringhe ASCII, può essere usa¬ 
ta nel campo dell'operando. Per esempio: 
QUI WORD 2 

QUO .WORD 1, $FF03, @ 3 
QUA .WORD QUI,QUO 
L'uso più comune di .WORD è per generare 
indirizzi, come mostrato nell'ultimo esempio, 
che immagazzina gli indirizzi a 16 bit QUI e 
QUO Nella serie 6500 gli indirizzi vengono 
posti in memoria nell'ordine byte basso-byte 
alto, dunque .WORD genera valori in que¬ 
st'ordine. 

La parte esadecimale nell’esempio verrebbe 
immagazzinata come 03,FF. Se non vuoi que¬ 
sto ordine, usa .DBYTE al posto di .WORD. 
.DBYTE è praticamente identico a .WORD, 
tranne per il fatto che i byte sono immagazzi¬ 
nati nell'ordine byte alto-byte basso. Per 
esempio: 

DBYTE $FF03 

genera FF,03. Per questo, i campi generati 
da .DBYTE non possono assolutamente es¬ 
sere usati come indirizzi. 

Uguale ( = ) è il comando di uguaglianza, ed 
è usato per riservare locazioni di memoria, per 
resettare il contatore di programma (*), o per 


assegnare un valore ad un'espressione. 
QUI ‘ = 1 +1 riserva un byte 
QUO ' = * + 2 riserva due byte 
' = S200 fissa il cont. di programma 
NB = B assegna un valore 
MB = NB + °/o 101 assegna un valore 
Il comando ' = ' è molto potente e può essere 
usato in una grande varietà di occasioni. 
Asterisco (*) è usato per modificare il valore 
del contatore di programma. Per creare un 
programma oggetto che venga assemblato a 
partire da un qualsiasi indirizzo maggiore di 
zero, deve essere usato il comando Per 
esempio ’* = $ 200 ', fa partire la compilazio¬ 
ne all'indirizzo $ 200 . 

Le espressioni non devono contenere riferi¬ 
menti a nomi definiti più avanti, o saranno se¬ 
gnalate come errori. Ad esempio: 

* = C + D — E + F 
viene considerata valida se C,D,E ed F sono 
state tutte definite, è invece segnalata come 
errore se una delle variabili è definita più 
avanti nel programma, o se non è definita af¬ 
fatto. Ricorda inoltre che l'espressione è cal¬ 
colata sempre da sinistra verso destra, senza 
alcuna priorità. 

.PAGE è usato per provocare un salto imme¬ 
diato all'inizio di pagina nel listato, e può es¬ 
sere usato per generare o per resettare il titolo 
stampato sul listato. 

.PAGE Questo è un titolo 
.PAGE 

.PAGE Nuovo titolo 

Se viene definito un titolo, esso viene stam¬ 
pato in cima ad ogni pagina fino a che non 
viene cancellato o sostituito con un altro. Un 
titolo può essere cancellato con: 

.PAGE ' ’ 

-SKIP è usato per generare linee vuote in un 
listato. Il comando non appare, ma la sua po¬ 
sizione può essere trovata In un listato. Il co¬ 
mando, pur non essendo stampato, è con¬ 
siderato come un inserimento valido dal lista¬ 
to, ed il numero sulla sinistra del listato stes¬ 
so salta di due quando la linea seguente viene 
stampata. 

.SKIP 2 salta due linee vuote 
.SKIP 3*2—1 salta cinque linee vuote 
.SKIP salta una linea 

.OPT è il comando più potente ed è usato per 
controllare la creazione dei campi di output, 
dei listati e delle espansioni delle stringhe 
ASCII nei comandi .BYTE. Le opzioni dispo- 
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nibili sono: ERRORS, NOERRORS, LIST, 
NOLIST, GENERATE, NOGENERATE. 
,OPT ERRORS, LIST, GENERATE 
,OPT NOE, NOL, NOG 
è anche valido: 

.OPT LIST, ERR 
I valori per difetto sono: 

.OPT LIST, ERR, NOGEN 

Ecco qui la descrizione di ogni opzione: 

ERRORS-NOERRORS: 

Usato per controllare la creazione di un file 
separato per gli errori. Il file di errore contie¬ 
ne la linea sorgente sbagliata ed il messag¬ 
gio di errore. Questa possibilità è di grande 
aiuto a quegli utenti che lavorano in time- 
sharing i quali hanno limitate capacità di stam¬ 
pa. Il file di errore può essere attivato ed esa¬ 
minato fino a che tutti gli errori sono stati 
corretti. Questo file di listato può poi essere 
esaminato. Un'altra possibilità è di lanciare la 
compilazione con: 

.OPT ERROR, NOLIST 

Fino a che tutti gli errori sono stati corretti, e 
quindi rilanciare con: 

OPT NOERRORS, LIST 

LIST-NOLIST : 

Usato per controllare la generazione dei file 
di listato contenente il programma sorgente, 
le segnalazioni di errore o pericolo, la gene¬ 
razione del codice, la tabella dei simboli ed 
il conteggio delle istruzioni (se abilitato). 

GENERATE-NOGENERATE: 

Usato per controllare la stampa delle stringhe 
ASCII nel comando BYTE. I primi due carat¬ 
teri vengono sempre stampati, mentre i carat¬ 
teri seguenti vengono stampati (normalmente 
due byte per linea) solo se si usa GENERATE. 

.END dovrebbe essere l'ultimo comando in un 
file ed è usato per segnalare la fine fisica del 
file stesso. Il suo uso è opzionale, ma lo si rac¬ 
comanda caldamente per la documentazione 
del programma. 

,LIB permette all'utente di inserire codice sor¬ 
gente proveniente da un altro file nell'assem- 
bler, Quando l’assembler incontra questo 
comando smette momentaneamente di leg¬ 
gere il codice sorgente dal file corrente ed ini¬ 
zia a leggere dal file nominato in .LIB. La 
lettura del file corrente ricomincia quando l'as- 
sembler incontra la fine del file libreria (EOF) 
oppure il comando .END. Il file contenente la 
.LIB può a sua volta contenere comandi per 


l'assembler che controllino le funzioni di li- 
sting, etc... 

-FIL può essere usato per concatenare un al¬ 
tro file al corrente durante la compilazione. Un 
file libreria non può contenere un altro .LIB, 
ma può contenere un comando .FIL. Un co¬ 
mando FIL conclude la compilazione dei file 
in cui è contenuto e trasferisce la lettura del 
codice sorgente ad un altro file nominato nel 
campo operando. Non ci sono restrizioni al 
numero di file che possono essere concate¬ 
nati con il comando .FIL. Bisogna fare atten¬ 
zione quando si usa questo comando a non 
creare concatenazioni circolari, i cui effetti so¬ 
no chiaramente imprevedibili. La compilazio¬ 
ne da parte dell'assembler può essere con¬ 
clusa solo da un (EOF) o da un comando 
.END. 

3.0 Generazione di macro 
Le macro hanno la struttura generale mostra¬ 
ta nel seguente codice: 

(etichetta) .MAC nome della macro 
Testo della Macro 
(etichetta) .MND 

Il comando MAC definisce una macro con il 
nome di macro definito, e crea fino a nove pa¬ 
rametri per quella macro. L'utente non dichia¬ 
ra esplicitamente i parametri. Le macro 
possono contenere qualsiasi testo tranne i co¬ 
mandi .MAC e .MND. Il comando .MND iden¬ 
tifica la fine della definizione di macro. Le 
etichette su .MAC e .MND sono opzionali, co¬ 
me indicato dalle parentesi. Esse si riferisco¬ 
no rispettivamente alla prima istruzione o 
comando generata ed all’istruzione o coman¬ 
do immediatamente successiva all'ultima. 
Per chiamare una macro l'utente deve sem¬ 
plicemente fornire il nome della macro e tutti 
i parametri necessari, come esemplificato nel¬ 
la linea seguente: 

nomemacro parami ,param2,param3... 

Il nome della macro deve essere delimitato da 
uno spazio prima del primo parametro, come 
si vede dall'esempio sopra. 

Nel testo della definizione di macro, un para¬ 
metro è indicato dal simbolo temporaneo ’?' 
seguito da un numero da 1 a 9; ?3 indica per¬ 
tanto il parametro 3. Durante la cojipilazio- 
ne, se l'assembler incontra la chiamata di una 
macro, il testo incluso in quella macro è inse¬ 
rito nel codice oggetto in quel punto ed i no¬ 
mi dei parametri al punto di chiamata sono 
sostituiti ai simboli temporanei. Se l'utente 
non fornisce il nome di un parametro quando 
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chiama una macro, l'assembler genera un no¬ 
me per quel parametro (se uno è necessario), 
per la durata della chiamata stessa. 

Per fare un breve esempio, supponiamo di vo¬ 
ler incrementare un numero in doppia preci¬ 
sione (16 bit). La definizione di macro da fare 
è questa: 

.MAC DPINC ; incremento in doppia PR. 

INC ?1 

BNE 72 

INC ?1 + 1 

?2 ,MND 

Quando la macro è chiamata per incremen¬ 
tare la variabile COUNT, bisogna immettere 
una linea come la seguente: 

DPINC COUNT 

Questo genera il seguente codice: 

INC COUNT 
BNE L001 
INC COUNT+1 
L001 

In questo esempio, l'etichetta interna ’LOOI ' 
è generata automaticamente durante la com¬ 
pilazione della macro. Chiamate successive 
producono etichette distìnte, seguendo la pro¬ 
gressione L002, L003, etc... Se il programma¬ 
tore fornisce un secondo parametro nella 
linea di chiamata, invece di lasciare quel pa¬ 
rametro vuoto, l’etichetta interna viene chia¬ 
mata come quel parametro, invece che L001. 
Una macro può chiamare un'altra macro, ma 
bisogna fare attenzione che l'annidamento 
non superi otto livelli. 

Parametri vuoti 

I parametri vuoti nelle linee di chiamata sono 
evidenziati da virgole: 

FUNCTN AA,„DD 

;i parametri ?2 e 73 sono vuoti, come sono 
vuoti quelli dal 75 al 79. 

FUNCTN „CC„EE 

;sono vuoti 71,72 e 74, cosi come da 76 a 79. 

Nomi concatenati 

I parametri delle macro vanno scritti senza 
spazi né davanti né dietro, in modo che un pa¬ 
rametro possa essere usato per creare nuovi 
nomi di variabili e per allocare spazio per le 
variabili. 

.MAC DICH ; spazio necessario 
XX? 1 .WOR 0 

* = ' + 72 
.MND 

DICH AA.5 ; chiamata alla macro 
XXAA .WOR 0 

* = ' + 5 ; così viene riscritta 


DICH A2, 10 ; seconda chiamata 
XXA2 .WOR 0 

■ = " + 10 ; così viene riscritta la seconda 
chiamata 

Nota che non ci sono spazi nelle etichette 
XXAA e XXA2. 

Espressioni come parametri 

I parametri della macro possono essere 
espressioni arbitrarie che non contengono vir¬ 
gole, punti e virgola o spazi. Quando le 
espressioni sono inserite nella definizione di 
macro,' l'espressione deve avere un significa¬ 
to per l'assembler. 

.MAC minore : se l'acc.<?1 allora 72 
CMP 71 
BCS 72 
.MND 

MINORE XX+ 5,EXIT 
{confronta con la loc. XX + 5 
MINORE #$F3,EXIT 
{confronta con $F3 
MINORE (XX, 1), EXIT 
{illegale - c'è una virgola! 

Formato di output dell'assembler 

Fai attenzione: il macro assembler usa rego¬ 
le differenti dal precedente assembler Com¬ 
modore per decidere come formattare una 
linea di stampa. La nuova regola è la seguen¬ 
te: un identificatore che inizia alla colonna 1 
é stampalo come un'etichetta, altrimenti è 
considerato un'istruzione. 

Questa regola è identica a quella usala dal- 
l'editor del comando FORMAT. Il comando 
FORMAT permette all'utente di vedere il for¬ 
mato finale stampato del file inserito. 

4.0 File di output generati dall’assembler 

Ci sono tre tipi di file di output-generati dal- 
l'assembler. Ogni file è opzionale e può es¬ 
sere creato tramite l'uso del comando .OPT. 

II file di listato contiene il listato del program¬ 
ma con gli errori e la tavola dei simboli. Il file 
di errore contiene tutte le linee errate e gli er¬ 
rori (come nel file di listato). Il file di interfac¬ 
cia contiene il codice oggetto per il caricatore. 
Il file di riferimento incrociato può essere ge¬ 
nerato opzionalmente dall'assembler. Questo 
file é usato dal programma di riferimento in¬ 
crociato per stampare un prospetto che mo¬ 
stri tutte le variabili, i loro indirizzi dichiarati 
e tutti i numeri di linea in cui esse sono usate. 

File di listato 

Il file di listato è prodotto ove non sia usata 


12 






l’opzione NOLIST nel comando .OPT. Que¬ 
sto file è formato da due sezioni: listato del 
programma e degli errori; tavola dei simboli. 
■ Listato del programma e degli errori. 
Contiene codice sorgente insieme con il co¬ 
dice compilato. Messaggi di errore e di peri¬ 
colo appaiono dopo ogni comando errato. 
(Una spiegazione dei messaggi di errore è ri¬ 
portata nell'Appendice VI). Alla fine del pro¬ 
gramma è mostrato il conteggio degli errori 
e dei pericoli riscontrati. 

• Tavola dei simboli. 

La tavola dei simboli viene prodotta allorché 
non venga usata l’opzione NOSYM. Contie¬ 
ne la lista di tutte le variabili e le costanti usa¬ 
te nel programma, ed i loro rispettivi indirizzi. 

File di interfaccia 

Questo tile non contiene il codice oggetto ve¬ 
ro e proprio, ma dati che possono essere letti 
dal caricatore e trasformati in codice macchi¬ 
na. Il formato del primo record e di tutti i suc¬ 
cessivi, tranne l’ultimo, è questo: 

; nino a3a2a1 aO(didO) 1 (dldO)2.. (dldO) 23 
x3x2x1xO 

Dove siano valide le seguenti regole: 

1. Tutti i caratteri (n,a,d.x) e i caratteri ASCII 
da A a F, rappresentano una cifra esade- 
cimale. 

2 . Il punto e virgola indica l’inizio di ogni 
record. 

3. nino 

numero di byte di dati in questo record (in esa- 
declmale). Ogni coppia di caratteri esadeci- 
cnali (dldO) rappresenta un singolo byte. 

4. a3a2a1a0 

Indirizzo iniziale esadecimale del record. a3 
rappresenta i bit d'indirizzo dal 15 al 12 , a 2 
quelli dall’ 1 1 all'8, etc.. Il byte rappresentato 
da (dldO) 1 è posto all'indirizzo a3a2a1a0, 
(dldO) 2 è posto a a3a2a1a0 + 1, etc.. 

5 (dldO) 

Coppia di cifre esadecimali che rappresenta¬ 
no un byte (8 bit) di dati, (di rappresenta i 4 
bit alti, d2 i 4 bit bassi). Sono permessi un 
massimo di 24 byte per ogni record. 

6. x3x2x1 xO 

Check sum (somma di controllo) del record. 
Questa è la somma esadecimale di tutti i ca¬ 
ratteri del record, inclusi nlnO e a3a2a1a0, 
esclusi il punto e virgola iniziale ed il check 
sum stesso. Per generare il check sum ogni 
byte di dati (rappresentato da due caratteri 
ASCII), viene trattato come otto bit binari. La 
somma binaria di questi byte a 8 bit è tronca¬ 
ta a 16 bit binari (4 cifre hex), ed è poi rap¬ 


presentata nel record come quattro caratteri 
ASCII ( x 3 x 2 x 1 x 0). 

Il formato dell’ultimo record in un file è il se¬ 
guente: 

; 00 c3c2c1 CO x3x2x 1x0 
1 . ; 00 

In questo record ci sono zero byte di dati: lo 
zero identifica l’ultimo record del file, 

2. c3c2c1c0 

Questo rappresenta il numero totale dei re¬ 
cord nel file, escluso l'ultimo. 

3. x3x2x1x0 

Check sum di questo record. 

5.0 Comandi Basic addizionali per la ge¬ 
stione del disco 

Sul disco c’è un programma che ti aiuta nel¬ 
le funzioni di gestione del disco (copiare, can¬ 
cellare, cambiare nome, leggere la directory, 
inizializzare il disk drive, controllare lo stato 
del disco e naturalmente caricare e lanciare 
i programmi dal disco). I comandi che questo 
programma fornisce sono semplici, rapidi e 
molto utili. 

5.1 Caricare il programma DOS WEDGE 64 

Quando questo programma è caricato, si in¬ 
serisce tra il sistema operativo ed il BASIC; 
esso controlla ogni carattere inserito dalla ta¬ 
stiera, prima di passarlo all'interprete BASIC, 
per individuare i comandi che lo interessano. 
(Questo è possibile inserendosi nella routine 
CHRGET di pagina zero). Per caricare il pro¬ 
gramma battete: 

LOAD "DOS WEDGE64", 8,1 
e premete RETURN. Questo carica un pro¬ 
gramma che a sua volta attiva il programma 
Wedge. Una volta caricato batti RUN e RE¬ 
TURN prima di togliere il dischetto dal drive. 
Non appena il programma viene lanciato, ap¬ 
pare un messaggio di copyright. 

5.2 Usare il programma DOS WEDGE64 

II programma supporta tutti i comandi inclusi 
nel BASIC (copia, cancella, cambia il nome, 
formatta), un comando per leggere la direc¬ 
tory (senza modificare la memoria) e coman¬ 
di per caricare e lanciare programmi. Esso ti 
viene anche in aiuto con la capacità di crea¬ 
re e gestire volumi di file (la creazione di vo¬ 
lumi ti permette di raggruppare alcuni 
programmi), e la capacità di compiere opera¬ 
zioni usando nomi collettivi per i file (ad esem¬ 
pio, lutti i file il cui nome comincia con un 
certo carattere). 

Ogni comando comincia con un carattere spe- 
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ciale, come specificato nella sezione 5.3. Il ca¬ 
rattere usato dipende dal comando. I simboli 
' @ ’ e '>' sono usati indifferentemente per 
introdurre un comando di gestione del disco 
o di lettura della directory. Essi sono anche 
usati per resettare o reinizializzare il drive, e 
per uscire dal DOS WEDGE. Il simbolo ' t ' 
(freccia in alto) è usato per introdurre il co¬ 
mando atto a caricare un programma (all'in¬ 
dirizzo BASIC 'Inizio del testo') e a lanciarlo 
automaticamente. Il simbolo / (barra obliqua 
discendente a sinistra) è usato per introdurre 
il comando che carica un programma all'In¬ 
dirizzo BASIC 'inizio del testo'. Il simbolo % 
(di percentuale) è usato per introdurre il co¬ 
mando che carica un programma al suo indi¬ 
rizzo di caricamento. Infine, il simbolo 
(freccia all'indietro) è usato per introdurre il 
comando che salva i file su disco. 

Comandi del programma DOS WEDGE64 

Nelle pagine seguenti è fornita la descrizio¬ 
ne di ogni comando. L'Appendice IX contie¬ 
ne un breve sommario di tutti i comandi del 
programma DOS WEDGE64. 

@ 

Battendo questo comando da solo si viene in¬ 
formati sullo stato del disco. Questo svolge 
la stessa funzione delle seguenti linee BASIC: 

10 OPEN 15,8.15 

20 INPUT #15,A,B$.C,D 
30 PRINT A;B$;C;D 

@ $(drive):(nomefile) (') ([volume]) 
Questo comando legge la directory del disk 
drive specificato e la stampa sullo schermo. 
Se viene specificato (nomefile), viene mostra¬ 
to solamente il file avente quel nome. Se vie¬ 
ne specificato (‘), vengono mostrati tutti quei 
file II cui nome inizia con i caratteri specifica¬ 
ti in (nomefile). Se viene specificato [volume], 
vengono mostrati solo i file contenuti in quel 
volume. 

@ N(drive):nomedisco,id 
Questo comando formatta un disco usando 

11 nome e l'id specificati. 

@ R(drive): nuovofile([volume]) = vec- 
chiofile([volume]) 

Questo comando cambia il nome del file 'vec- 
chiofile’ in 'nuovofile'. 

@ C(drive): nuovofile([volume]) = vec- 
chiofile([volume]) 

Questo comando copia il file specificato, in 
'vecchiofile' con il nome 'nuovofile'. Se vie¬ 
ne specificato [volume], il nuovo file viene ge¬ 
nerato in quel volume. 


@ S(drive):nomefilefX[volume]) 
Questo comando cancella il file il cui nome 
è specificato in 'nomefile'. Se viene specifi¬ 
cato ("), vengono cancellati tutti i file il cui no¬ 
me inizia con i caratteri contenuti in 
'nomefile'. Se viene specificato [volume], ven¬ 
gono cancellati solo i file contenuti in quel 
volume. 

@UI(drive) 

Questo comando resetta il DOS. 

@ I(drive) 

Questo comando mizializza il disk drive. 
@Q 

Questo comando esce dal programma 
Wedge. 

/nomefile 

Questo comando carica il file specificato da 
'nomefile'. Ad esempio: 

/ASM.C64 

Fa si che il programma chiamato 'ASM.C64' 
venga caricato in memoria. Questo comando 
è l'equivalente della linea BASIC: 

LO AD ''ASM.C64",8 

Ricorda che questo comando è utilizzabile so¬ 
lo per caricare programmi in BASIC, o pro¬ 
grammi in linguaggio macchina che vengano 
lanciati da BASIC, in quanto il computer igno¬ 
ra l'indirizzo di caricamento proprio del file, 
e lo carica sempre all'indirizzo BASIC 'Inizio 
del Testo'. 

%nomefile 

Questo comando carica il file specificato da 
'nomefile' a partire dall’indirizzo di caricamen¬ 
to proprio del file stesso. È l’equivalente del¬ 
la seguente linea BASIC: 

LOAD "nomefile",8,1 

dove 'nomefile' è il nome del programma da 
caricare. 

t nomefile 

Questo comando permette all'utente di cari¬ 
care e lanciare il programma specificato da 
'nomefile', éd è equivalente a: 

LOAD "nomefile", 8.1 
seguito dal comando BASIC ’RUN'. 
ATTENZIONE: anche questo comando per¬ 
mette solamente di caricare programmi in BA¬ 
SIC, o programmi in linguaggio macchina, 
lanciati da BASIC. 

•- nomefile 

Questo comando salva il programma specifi¬ 
cato da 'nomefile' su disco 

6.0 Creare ed editare un file sorgente 

L'editor è usato per creare e modificare file 
sorgenti per l'assembler. Esso mantiene tut¬ 
te le caratteristiche dell'editor a tutto scher- 
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mo del BASIC, ed inoltre permette la nume¬ 
razione automatica delle righe (AUTO), la ri¬ 
cerca di stringhe (FIND), la sostituzione 
(CH ANGE), la cancellazione di righe in un in¬ 
tervallo (DÈLETE) e la rinumerazione automa¬ 
tica (NUMBER). Altri comandi includono GET. 
PUT, BREAK, KILL e FORMAT. Tutti i coman¬ 
di sono elencati in dettaglio nel sommario al¬ 
la fine di questa sezione. 

I comandi dell'editor operano in modo simile 
ai comandi già esistenti nell’editor del BASIC, 
Per tare pratica vi suggeriamo di creare alcuni 
file di esempio usando i comandi dell'editor. 
I file di dati sui quali opera l'assembler sono 
composti di caratteri ASCII CBM. con ogni li¬ 
nea terminante con un carriage return (ritor¬ 
no di carrello). La sola restrizione nei file di 
dati è nel nome: a causa del metodo con cui 
i nomi vengono esaminati dall'assembler, in¬ 
fatti. non possono contenere alcuno spazio. 
I file sono sequenziali e devono terminare con 
un byte zero ($00). Quando richiedete la di¬ 
rectory. questi file sono mostrati come file di 
tipo SEQ. Il formato di ogni file è sequenziale 
quando questo termina con un byte zero 
($ 00 ). 

6.1 Caricare il programma Editor 64 

L'editordeve essere caricato con il comando 
BASIC LOAD: 

LOAD "EDITOR64'\8,1 
oppure 0 /oO:EDITOR64 (se II programma wed- 
ge è abilitato). 

Per lanciare l'editor battete 'SYS49152'. Do¬ 
po aver battuto il comando SYS, l'editor ri¬ 
sponde con un messaggio che indica che 
l'editor 64 è stato attivato. A questo punto batti 
NEW per resettare il puntatore del testo. Ora 
sei pronto a creare o modificare un file 
sorgente. 

6.2 Uso del programma Editor 64 

Quando il programma Editor64 è attivo, qual¬ 
siasi comando BASIC battuto cosi: 

10 FOR A = 1 TO 10 
non viene tokenizzato (convertito in token, pa¬ 
rola chiave BASIC che occupa un solo byte). 
Per questo non si possono battere linee BA¬ 
SIC se l'editor è attivato. Per superare que¬ 
sto problema è sufficiente disattivare l'editor 
con il comando 'KILL', o resettare il compu¬ 
ter per tornare al BASIC. 

I file sorgente vengono caricati con il coman¬ 
do 'GET'. Non appena il file è caricato in me¬ 
moria, l'editor genera automaticamente i 
numeri di linea, partendo da 1000. Dopo aver 


editato un file, aspicurati che l’ultima linea 
contenga un comando. FILE o .END. Poi sal¬ 
va il file su disco con il comando 'PUT'. 
Importante: assicurati di salvare il file con 
'PUT' prima di caricare l’assembler, altri¬ 
menti il file viene perduto. 

Nell'Appendice VII è contenuto il sommario 
dei comandi del programma Editor64. 
Comandi del programma Editor64. 

AUTO 

Il comando AUTO genera automaticamente 
i numeri di linea quando si inserisce un nuo¬ 
vo file sorgente. Per attivare il comando AU¬ 
TO batti: 

AUTO ni 

dove ni è l'incremento opzionale tra i nume¬ 
ri di linea stampati. Per disabilitare la funzio¬ 
ne AUTO, batti AUTO senza alcun operando. 

CHANGE 

Il comando CHANGE individua una stringa e 
la sostituisce automaticamente con un'altra. 
Il formato di questo comando è il seguente: 

CHANGE/str1/str2/,(n1-n2) 

/ delimita stri e str 2 (usa qualsiasi carattere 
che non sia in nessuna delle stringhe) 
stri stringa da cercare 
str 2 stringa sostitutiva 
,n 1 -n 2 parametro di intervallo. Il formato è il 
medesimo del comando LIST in BASIC. Se 
viene omesso, il comando opera in tutto il file 
(Opzionale). 

CPUT 

Il comando CPUT salva su disco il file sorgen¬ 
te per la successiva compilazione, eliminan¬ 
do gli spazi non necessari. La sintassi è la 
medesima del comando PUT. 

DELETE 

La funzione DELETE permette all'utente di 
cancellare più linee contemporaneamente. In¬ 
serisci l'intervallo di linee da cancellare (da 
ni a n2). Il formato è lo stesso del comando 
LIST in BASIC. 

DELETE n1-n2 

Per cancellare una singola linea batti il nume¬ 
ro di linea su di una linea vuota e premi 
RETURN. 

FIND 

Il comando FIND è usato per cercare ed indi¬ 
viduare una specifica siringa dì caratteri. Ogni 
ricorrenza della stringa viene stampata sullo 
schermo. Si può fermare la stampa con la bar- 
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ra spaziatrice. La stampa può poi essere ri¬ 
pristinata premendo ancora la barra spazia¬ 
trice. oppure fermata definitivamente con il 
tasto R UN/STOP. 

Il formato del comando FINO è: 

FIND/str1/str2/.(n1-n2) 

/ delimitatore (usa un carattere che non sia 

in nessuna delle due stringhe) 

stri stringa da cercare 

,n1-n2 parametro di intervallo. Uguale a quello 

del comando LIST in BASIC (Opzionale). 

Stampa FORMATtata 

Il comando FORMAT è usato per stampare 
testo in formato tabulato come l'assembler. 
Perché questa funzione lavori correttamente, 
devi battere gli mnemonici nella colonna due, 
o ad uno spazio di distanza dalle etichétte. 
FORMAT (n1-n2) 

n 1 -n 2 parametro di intervallo dello stesso for¬ 
mato di LIST (Opzionale) 

Nota: questo comando ha gli stessi controlli 
di FIND. Ad esempio premi la barra spazia¬ 
trice per fermare e far ripartire la stampa ed 
il tasto RUN/STOP per abortirla. 

GET 

Questo comando serve a caricare da disco file 
sorgente di testo dell'assembler nell'editor. 
Esso può anche essere usato per aggiunge¬ 
re file ad altri file già in memoria. 

GET "nomefile'', (ni), (n2). (n3) 
ni comincia a caricare il file sorgente a parti¬ 
re da questa riga del file in memoria. 
n 2 numero di device (periferica). Il valore per 
difetto è 8 (Opzionale). 
n3 indirizzo secondario. Il valore per difetto 
è 8 (Opzionale). 

Nota: GET comincia a numerare le linee da 
1000, con incrementi di 10. Se ni è più gran¬ 
de di qualsiasi numero di linea in memoria, 
il file da caricare è concatenato alla fine del 
file corrente. 

KILL 

Questo comando disabilita l'editor. Per rilan¬ 
ciare l'editor, batti lo stesso comando usato 
per lanciarlo (SYS49152). 

LIST 

Il comando dell'editor LIST lavora come il me¬ 
desimo comando BASIC. 

List (n1)-(n2) 

dove n 1 -n 2 rappresenta l'intervallo di linee in- 
cui il comando agisce. Sono considerati vali¬ 
di anche i parametri 'ni-' (che lista tutte le 


linee a partire dalla linea ni), e -n2' (che li¬ 
sta le linee comprese tra la prima e n2). 

NUMBER 

La funzióne NUMBER permette all'utente di 
rihumerare tutto o parte del file in memoria. 

NUMBER (ni), (n2), (n3) 
ni numero della vecchia linea iniziale 
n 2 numero della nuova linea iniziale 
n3 incremento di rinumerazione 
Nota: tutti i parametri sono opzionali. 

PUT 

Il comando PUT salva II file sorgente su di¬ 
sco per la successiva compilazione. PUT può 
salvare tutto o parte del file residente In 
memoria. 

PUT "nomefile", (n1-n2),(n3),(n4) 
ni numero della linea iniziale 
n2 numero della linea finale 
n3 numero di device, per difetto è 8 
n4 indirizzo secondario, per difetto è 8 
Tutti i parametri sono opzionali. Se vengono 
omessi tutti i parametri, l’intero file viene sal¬ 
vato su disco. 


7.0 Compilare un file sorgente 

Quando un file sorgente è pronto per essere 
compilato devi innanzitutto salvarlo su disco 
(usando il comando PUT). Assicurati di com¬ 
piere questa operazione prima di caricare il 
programma assembler, altrimenti son dolori. 
Una volta fatto questo, potrai caricare l'as¬ 
sembler, che risiede nella stessa zona dei pro¬ 
grammi BASIC. 

7.1 Caricare il programma Assembler 64 

Per caricare l'assembler batti: 

LOAD "ASSEMBLER64 ",8 
(o /ASSEMBLER64 se è stato caricato il pro¬ 
gramma DOS WEDGE64) 

Quando il caricamento è completato, batti 
RUN e premi RETURN. 

L'assembler stampa una prima richiesta. 

7.2 Usare il programma Assembler64 

Quando si sta compilando un programma, si 
possono creare due tipi di file: il primo è un 
file oggetto che contiene i dati necessari per 
creare un programma in codice macchina me¬ 
diante il loader (caricatore). Il nome di que¬ 
sto file è specificato dall'utente prima che 
cominci la compilazione. Gli altri file sono file 
di cross reference. Il nome di questi file è ge- 
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neralo automaticamente dall'assembler, ed è 
nel formato XXLLOOOO' e 'XXFFOOOO'. 
Bisogna notare che l'assembler non riscrive 
mai nessuno di questi file (cancellando i file 
aventi il medesimo nome), quindi se vuoi usa¬ 
re lo stesso nome per i file oggetto ogni volta 
che assembli un programma devi cancellare 
dal disco i vecchi file oggetto prima di carica¬ 
re l'assembler. Lo stesso discorso vale natu¬ 
ralmente anche se vuoi creare nuovi file di 
cross reference. 

Sebbene ti sia data l'opzione di creare sia un 
file oggetto, sia un file di cross reference, so¬ 
lo una di queste opzioni può essere scelta (a 
causa del numero di file aperti contempora¬ 
neamente). Se vuoi entrambi i file, lancia l'as- 
sembler una volta con l'opzione file oggetto, 
un'altra volta con l'opzione cross reference. 
Quando l'assembler parte, la prima richiesta 
è: 

NOME OGGETTO (RET/NO o D: NOME): 
Se vuoi che l'assembler crei un file oggetto, 
inserisci il nome del file e premi RETURN, al¬ 
trimenti premi solo RETURN. Poi viene stam¬ 
pata la richiesta: 

STAMPANTE (RET/S o N)? 

Se vuoi una copia su stampante, premi Y e 
RETURN o semplicemente RETURN, altri¬ 
menti. premi N seguito da RETURN. Questo 
fa si che il listato sia stampato sullo schermo. 
Poi viene stampata la richiesta: 

CROSS REFERENCE (RET/o Y)? 

Se vuoi che sia creato un file di cross refe¬ 
rence, premi Y seguito da RETURN, altrimenti 
solo RETURN. Infine viene stampata la ri¬ 
chiesta: 

NOME PRG SORGENTE? 

Batti il nome del file sorgente che vuoi as¬ 
semblare. 

Ricevuta quest'ultima informazione, l'assem- 
bler comincia a lavorare. Se durante la com¬ 
pilazione la tabella dei simboli trabocca, il 
processo di compilazione si ferma. 

Fermare l’assembler 

Quando l'assembler sta lavorando, le opera¬ 
zioni possono essere fermate premendo il ta¬ 
sto RUN/STOP. Se questo viene fatto, il 
processo di compilazione viene fermato ed il 
programma attende che l'utente decida se 
continuare o porre fine alla compilazione. Pre¬ 
mi il tasto B per porre fine alla compilazione 
e per tornare al BASIC, un qualsiasi altro ta¬ 
sto per continuare. Questa possibilità è utile 
soprattutto per chi non possiede la stampan¬ 
te, perché permette di esaminare il listato 


sullo schermo durante la compilazione. 

File di riferimento incrociato 
(Cross reference) 

Se scegli di produrre un riferimento incrocia¬ 
to verranno creati due file, come accennato 
sopra. Per esaminare o produrre un listato su 
stampante del riferimento incrociato, devi pri¬ 
ma caricare un apposito programma, in que¬ 
sto modo: 

LOAD "CROSSREF64'',8 
Quando il programma è stato caricato, batti 
RUN seguito da RETURN ed il programma 
stampa la seguente richiesta: 

NOME OGGETTO (RET o D: NOME): 
Premi RETURN se vuoi un listalo su stampan¬ 
te, altrimenti batti N seguito da RETURN. 

8.0 Caricare un file oggetto 

L’assembler del Commodore 64 produce file 
trasportabili in formato ASCII, che non pos¬ 
sono essere eseguiti direttamente. È neces¬ 
sario infatti che questi siano caricati mediante 
un particolare programma chiamato LOADER 
(caricatore) per poter essere lanciati. 

8.1 Caricare il programma LOADER 

Nel disco sono incluse due versioni del LOA¬ 
DER, posizionate in differenti aree delia me¬ 
moria RAM. Questo permette all'utente di 
caricare programmi ovunque nella RAM usan¬ 
do il caricatore corretto. Per caricare uno dei 
due LOADER, batti: 

LOAD ”nomefile",8,1 

dove "nomefile" è il nome del programma da 
caricare. La seguente tabella mostra i nomi, 
gli indirizzi di caricamento ed i comandi per 
lanciare ognuno dei due caricatori. 

Comando 

Nome Indirizzo di lancio 

LOLOADER64 S0800 RUN 

HILOADER64 SC800 SYS 51200 

8.2 Usare i programmi di caricamento 
(Loader) 

Entrambi i programmi di caricamento (HILOA- 
DER e LOLOADER) sono lunghi circa 512 by¬ 
te e operano allo stesso modo. Quando viene 
attivalo, il caricatore stampa un messaggio di 
copyright e richiede all'utente di inserire uno 
scostamento di caricamento. Lo scostamento 
è usalo per porre il codice oggetto ad un indi¬ 
rizzo differente da quello in cui è stato assem¬ 
blato. Questo permette all'utente di assemblare 
per una zona in cui non c’è RAM e di caricare 
in una zona RAM. 
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L'oggetto può in questo modo essere program¬ 
mato in un’EPROM etc. Lo scostamento è un 
indirizzo esadecimale di due byte che viene 
sommato agli indirizzi del programma. Se l'in¬ 
dirizzo del programma, sommato allo scosta¬ 
mento, dà un valore maggiore di $FFFF, 
l'indirizzo riparte da SOOOO. Gli esempi seguen¬ 
ti mostrano come lavora lo scostamento: 


Ind. di prog. 

Scost. 

Ind. del 
codice oggetto 

$0400 

$0000 

$0400 

$3000 

$0000 

$3000 

$0400 

$2000 

$2400 

$9000 

$9000 

$2000 

$E000 

$4000 

$2000 


Dopo che è stato inserito lo scostamento, il ca¬ 
ricatore richiede all'utente il nome del tile og¬ 
getto da caricare. Il caricatore poi inizializza 
il drive, cerca il file e comincia il caricamento. 
Quando il caricamento è completato, il carica¬ 
tore stampa il messaggio. 

FINE CARIO, e ritorna al BASIC. Possono ve¬ 
rificarsi tre errori durante il caricamento: 
ERRORE CONTO REC 
(conteggio dei record errato) 

CAR, NON -RAM 

(caricamento in una zona di memoria a sola 
scrittura) 

ERRORE SOMMA 

(errore nella somma di controllo) 

Gli errori sono considerati fatali; il caricamen¬ 
to termina, il file oggetto viene chiuso e viene 
restituito il controllo al BASIC. 

9.0 Controllare e correggere con i program¬ 
mi monitor 

Ci sono due monitor di linguaggio macchina 
sul disco: Monitor$8000 e MonitorSCOOO. La 
sola differenza tra di loro è l'area di memoria 
in cui risiedono. Il programma MonitorS8000 
risiede alla locazione di memoria S8000 ed il 
programma MonitorSCOOO risiede alla locazio¬ 
ne SCOOO. Sono incluse le due versioni nel ca¬ 
so una di loro interferisca con le locazioni in 
cui volete che risieda il programma da control¬ 
lare. Per caricare ed attivare il monitor appro¬ 
priato battete: 

LOAD "MONITOR$8000'\8,1 
(monitor a S8000) 

SYS 32768 

oppure 

LOAD ''MONITORSCOOO", 8,1 
(monitor a SCOOO) 

SYS 49152 

9.2 Usare i programmi Monitor 

I programmi Monitor, non appena caricati, 


mostrano i registri della CPU, stampano un 
punto e fanno lampeggiare il cursore. Il punto 
serve ad informarti che il programma è in at¬ 
tesa di un tuo comando. I comandi sono de¬ 
scritti uno per uno nelle pagine che seguono. 
Nell'appendice Vili c’è inoltre un sommario dei 
comandi dei programmi Monitor. 

Per uscire dal programma Monitor devi reset- 
tare il computer. 

9.3 Comandi del programma Monitor 
Comando A 

Fine: inserire una linea di codice assembler 
Sintassi: A (indirizzo) (codifica) (operando) 
(indirizzo): un numero esadecimale di quattro 
cifre indicante la locazione di memoria in cui 
porre la codifica. 

(codifica mnemonica): una codifica mnemoni¬ 
ca standard nel linguaggio assembler MOS, 
ad Es. LDA, STX, ROR, etc., come definito nel¬ 
l’Appendice IV. 

(operando): l'operando, quando è richiesto, 
può essere in uno qualsiasi dei modi di indi¬ 
rizzamento legali. Per i modi di pagina zero è 
necessario un numero esadecimale di quattro 
cifro il cui valore sia minore o uguale a $FF. 
Per gli indirizzi in pagine diverse dalla zero è 
necessario un numero esadecimale di quattro 
cifre il cui valore sia minore o uguale a SFFFF. 
Un RETURN viene usato per indicare la fine 
della linea in linguaggio assembler. Se vengo¬ 
no riscontrati errori, un punto di domanda in¬ 
dica l'errore, e viene stampato un punto sulla 
linea successiva. L'editor di testo può essere 
usato per correggere gli errori sulla linea ori¬ 
ginale. 

Dopo che una linea di codice è stata assem¬ 
blata con successo, l'assembler stampa la 
successiva locazione legale per un'istruzione, 
in modo che non ci sia bisogno di battere 'A' 
e l'indirizzo più di una volta, quando si inseri¬ 
scono programmi in linguaggio assembler nel 
Commodore 64. Per uscire da questo modo, 
premi RETURN dopo la scritta 'A', generata dal 
computer. 

Esempio: .A 1200 LDX «S00 
.A 1202 

Comando C (compare) 

Fine: conlrontare due zone di memoria. 
Sintassi: C (ind. iniziale) (ind. finale) (ind. com¬ 
parando) 

(indirizzo iniziale): numero esadecimale di 
quattro cifre che indica l'indirizzo iniziale del¬ 
la prima delle due aree di memoria. 
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(indirizzo finale): numero esadecimale di quat¬ 
tro cifre che indica l’indirizzo finale della pri¬ 
ma delle due aree di memoria. 

(indirizzo comparando): numero esadecimale 
di quattro cifre che indica l'indirizzo iniziale del¬ 
la seconda area di memoria. 

I campi degli indirizzi devono essere separati 
da un delimitatore valido, come uno spazio o 
una virgola. Se le due zone di memoria sono 
uguali, il programma stampa un punto. L'indi¬ 
rizzo di ogni byte differente nelle due zone vie¬ 
ne stampato sullo schermo. 


Comando D (disassemble) 

Fine: disassemblare del codice macchina in 
linguaggio assembler (è il processo inverso 
della compilazione) 

Sintassi: D (indirizzol) (Indirizzo 2) 

(indirizzo 1 ): l’indirizzo inziale del codice da di¬ 
sassemblare espresso da un numero esade¬ 
cimale di quattro cifre. 

(indirizzo 2):jndirizzo finale (opzionale) del co¬ 
dice da disassemblare, espresso da un nume¬ 
ro esadecimale di quattro cifre. 

I campi di indirizzo devono essere separati da 
un delimitatore valido, come uno spazio o una 
virgola. Il formato del disassemblato è solo leg¬ 
germente differente da quello deH'assembler 
che si inserisce da tastiera. La differenza sta 
nel fatto che il primo carattere di un disassem¬ 
blato è una virgola invece di una 'A', per una 
migliore leggibilità. 

Un listato disassemblato può essere modifica¬ 
to usando l’editor di schermo. Fai qualsiasi mo¬ 
difica allo mnemonico e/o all’operando e premi 
RETURN. Questo inserisce la linea e chiama 
l’assembler per ulteriori modifiche. 

Un disassemblato può essere fatto scorrere su 
e giù per lo schermo mediante i controlli del 
cursore. Quando una linea di disassemblato 
è in fondo allo schermo, la pressione del ta¬ 
sto 'cursore in basso' provoca lo scorrimento 
di una linea verso l’alto, per permettere la vi¬ 
sualizzazione di un'altra linea di codice. Que¬ 
sto procedimento funziona anche per 
procedere a ritroso in un disassemblato, an¬ 
dando in cima allo schermo e premendo il ta¬ 
sto 'cursore in alto'. 


Es. D 1000 1400 , 

; 1000 LDA # S00 
; 1002 ??? 

; 1003 BNE SF1030 

Comando F (fili) 

Fine: riempire un insieme di locazioni con un 
determinato byte. 

Sintassi: F (indirizzol) (indirizzo2) (byte) 

(indirizzol): prima locazione da riempire con 
il valore specificato da (byte) 

(indirizzo2): ultima locazione da riempire con 
il valore specificato da (byte) 

(byte): numero esadecimale di due cifre da 
scrivere nelle locazioni di memoria consecuti¬ 
ve specificate. 

Questo comando è utile per inizializzare strut¬ 
ture di dati o qualsiasi altra area di RAM. 

Es. F 0400 0518 EA 

Riempe le locazioni di memoria da $0400 a 
$0518 con il valore SEA (l'istruzione NOP) 

Comando G (go) 

Fine: cominciare l'esecuzione di un program¬ 
ma all'indirizzo specificato. 

Sintassi: G (indirizzo) 

(indirizzo): argomento opzionale che specifica 
il nuovo valore del contatore di programma e 
l'indirizzo dal quale deve partire l'esecuzione. 
Quando l’indirizzo viene omesso l’esecuzione 
parte dal valore corrente del contatore di pro¬ 
gramma (che può essere visionato con il co¬ 
mando R) 

Il comando G ripristina tutti i registri e comin¬ 
cia l'esecuzione all'indirizzo iniziale specifica¬ 
to. Si raccomanda la prudenza nell'usare 
questo comando. (Sarebbe saggio porre un 
punto di uscita (breakpoint) da qualche parte 
nella linea dell'esecuzione del programma, per 
prevenire la perdita del controllo del sistema 
operativo.) 

Es. G 040C 

L’esecuzione comincia alla locazione S040C. 
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Comando H (hunt) 

Fine: cerca nella memoria tutte le ricorrenze 
di un insieme di byte in un intervallo speci¬ 
ficato. 

Sintassi: H (indirizzo - !) (indirizzo2) (dati) 

(indirizzo - !): indirizzo iniziale della ricerca 

(indirizzo 2 ): indirizzo finale della ricerca. 

(dati): insieme di dati da cercare (possono es¬ 
sere valori esadecimali o una stringa ASCII) 

Una stringa ASCII è individuata da una virgo- 
letta semplice che precede il primo carattere 
(ad es. 'STRINGA). Gli argomenti esadecima¬ 
li di due cifre devono essere separati l'uno dal¬ 
l’altro da uno spazio. 

Es. H C000 FFFF CIAO ; cerca la stringa 
ASCII CIAO 

H A000 A101 A9 FF 4C ; cerca i valori A9, FF, 
4C, in questa sequenza 

Comando I (interrogate) 

Fino: mostra la memoria in formato ASCII nel¬ 
l’intervallo di locazioni specificato. 

Sintassi: I (indirizzo!) (indirizzo2) 

(indirizzo! ): indirizzo della prima locazione. 

(indirizzo 2 ): indirizzo dell'ultima locazione. 

I caratteri ASCII sono mostrati in video inver¬ 
so per contrasto con i dati esadecimali visua¬ 
lizzati sullo schermo. 

Lo schermo può venire fatto scorrere usando 
il tasto up/down del cursore. Questo permette 
di continuare a cercare tra i parametri di ricerca. 

Nota: quando un carattere non è stampabile, 
al suo posto viene visualizzato un punto (.). 

Es. I C000 C020 

Visualizza in inverso i caratteri compresi tra 
$C000 e $C020 

Comando L (load) 

Fine: caricare un file da cassetta o da disco. 


Sintassi: L "nomefile". (device) 

nomefile: qualsiasi nome di file legale sul Com¬ 
modore 64 

(device): un byte di due cifre indicante la peri¬ 
ferica da cui caricare il file. 

0 ! è da cassetta 
08 è da disco (o 09, etc) 

Il comando Load fa si che un file venga cari¬ 
cato in memoria. L'indirizzo di partenza è con¬ 
tenuto nei primi due byte del file stesso (in un 
file PGM). In altre parole un comando LOAD 
carica sempre i file nella stessa zona da cui 
sono stati salvati. Questo è molto importante 
lavorando in linguaggio macchina, in quanto 
solamente pochi programmi sono compieta- 
mente rilocabili. Il file viene caricato in memo¬ 
ria fino a che viene trovato il segnale di fine 
del file (EOF). 

Es. L "SCREEN", 01 ; carica un file da 
cassetta 

L ’ SCREEN 1 ', 08 ; carica un file da disco 

Comando M (memory display) 

Fine: visualizzare il contenuto della memoria 
nell'intervallo di locazioni specificato. 

Sintassi: M (indirizzo!) (indirizzo2) 

(indirizzo!): indirizzo di partenza 

(indirizzo2): indirizzo finale (Opzionale. Se vie¬ 
ne omesso vengono mostrati otto byte.) 

La memoria è visualizzata nel seguente 
formato: 

.:A048 7F E7 00 AA AA AE 02 FF 

Il contenuto della memoria può essere modi¬ 
ficato usando l'editor di schermo. Per edita¬ 
re. muovi il cursore ai dati da moditicare, batti 
le correzioni necessarie e premi RETURN. Se 
c'è una locazione RAM errata o se si tenta di 
modificare una locazione ROM, viene mostra¬ 
to un segnale di errore (?). 

Come nei comandi D(DISASSEMBLE) e ((IN¬ 
TERROGATE), il contenuto dello schermo 
può venire fatto scorrere su e giu usando i 
controlli del cursore. 
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Es. MOOOO 

OOOO 4C 7F EF AA 00 02 F7 FF 

Vengono visualizzati i primi otto byte di 
memoria. 

Comando N (new locator) 

Fine: rilocare riferimenti assoluti alla memo¬ 
ria sommando uno scostamento all'operando 
del codice. 

Sintassi: N (indi) (ind2) (scostamento) (reti) 
(ref2) W 

(indi): indirizzo iniziale del codice da modi¬ 
ficare 

(ind 2 ): indirizzo finale del codice da modificare 

(scostamento): valore da sommare all’operan¬ 
do delle istruzioni. Il codice spostato da una 
zona più alta ad una più bassa della memo¬ 
ria ha bisogno di un valore particolare. Per ot¬ 
tenere questo valore bisogna sottrarre lo 
scostamento voluto da 65536 ($10000). Se ad 
es. vuoi spostare una parte di codice da 
$A00O (40960) a $0400 (1024), il valore dello 
scostamento è $6400 (25600). infatti 
-65536-(40960-1024) = 25600. Per capire me¬ 
glio il signficato di questa operazione, devi ra¬ 
gionare con i numeri esadecimali: 
SA000+ S6400 è uguale a SI 0400, ma poiché 
il computer non possiede il bit nove, il risulta¬ 
to è S0400. 

(refi): ogni operazione lunga tre byte il cui 
operando sia maggiore o uguale a (refi) e mi¬ 
nore di (ref 2 ) viene rilocata con uno scosta¬ 
mento uguale a (scostamento). 

L'operando dell'istruzione lunga tre byte vie¬ 
ne cioè rimpiazzato da 'operando + (sco¬ 
stamento)'. 

(ref 2 ): limite superiore degli operandi da rilo¬ 
care (vedi refi). Ogni operando con un valo¬ 
re maggiore o uguale a (ref 2 ) non viene 
rilocato. 

W: riloca le tabelle di WORD (opzionale). Se 
viene incluso W, tutte le coppie di byte ven¬ 
gono rilocate. La rilocazione diviene cosi in¬ 
dipendente dai dati. 

Spesso è utile muovere una parte di codice 
da una zona di memoria ad un'altra (vedi il 


comando T) per fare spazio ad altro codice. 
Usando il comando N’, il codice può essere 
modificato per funzionare al nuovo indirizzo. 

Comando R (register display) 

Fine: mostra i registri importanti del 6502: il 
registro di stato del programma, il contatore 
di programma, l’accumulatore, i registri indi¬ 
ce X e Y, il puntatore dello stack. 

Sintassi: R 

Nota che il puntatore dello stack è visualiz¬ 
zato senza l'ottavo bit implicito. Dal momen¬ 
to che è stato menzionato l'ottavo bit del 
puntatore dello stack, è bene far notare un di¬ 
fetto del 6502. Quando viene eseguita un'i¬ 
struzione PHP, sull'ottavo bit del puntatore di 
stack viene compiuta un'operazione di OR lo¬ 
gico con il byte di stato, ed il risulatato viene 
immagazzinato nello stack con il bit quattro 
(il flag di break!) sempre settato. Per il 99,9% 
delle applicazioni, questo non crea problemi. 
Purtroppo però quando questo difetto viene 
a galla, causa problemi molto difficili da indi¬ 
viduare. 

Es. R 

PC SR AC XR YR SP 
.; 057F 01 02 03 04 FE 

Comando S (save) 

Fine: salvare il contenuto della memoria su 
registratore o su disco. 

Sintassi: S "nomefile", (device), (indirizzol), 
(indirizzo2) nomefile: qualsiasi nome legale 
per salvare dati. 

Il nome del file deve essere racchiuso tra dop¬ 
pie virgolette; le virgolette semplici sono il¬ 
legali. 

(device): le due periferiche possibili sono il re¬ 
gistratore a cassette ed il disk drive: per sal¬ 
vare su cassetta usa 01 , per salvare su disco 
usa 08. 

(indirizzol): indirizzo iniziale della memoria da 
salvare. 

(indirizzo 2 ): indirizzo finale della memoria da 
salvare, più uno. Tutti i .dati fino a quell'indi¬ 
rizzo, escluso il byte a quell'indirizzo, vengo¬ 
no salvati. 






Il file crealo da questo comando è un lile di 
caricamento, ovvero contiene nei primi due by¬ 
te l'indirizzo iniziale dei dali (indirizzol). Il (ile 
può essere richiamato con il comando 'L'. 

Es. S "GAME”, 08,0400,0000 

Salva la memoria da $0400 a S0C00 su disco. 

Comando T (transfer) 

Fine: trasferire segmenli di memoria da una 
zona ad un'altra. 

Sintassi: T (indirizzol) (indirizzo2) (indirizzo3) 

(indirizzol): indirizzo iniziale dei dati da 
spostare 

(indirizzo2): indirizzo finale dei dati da spostare 

(indirizzo3): indirizzo inziale della nuova'zona 
di memoria in cui vengono posti i dati 

I dati possono essere spostati da una zona 
bassa ad una alta e viceversa. Segmenti di 
memoria di qualsiasi lunghezza possono es¬ 
sere mossi in avanti o all'indietro di un nume¬ 
ro qualsiasi di byte. 

Es. T 1400 1600 1401 

Sposta i dati da $1400 lino a $1600 (incluso) 
un byte più in alto nella memoria. 


APPENDICE III 

DESCRIZIONE DEI FILE CONTENUTI 
SUL DISCO 

ASSEMBLER64 - Vedi la sezione 7. Questo 
è l'assembler vero e proprio, che viene cari¬ 
calo nella zona bassa della memoria ed as¬ 
sembla i file creali con il programma EDITOR. 
Per caricare l'assembler batti LOAD 
“ASSEMBLER64’’, 8, oppure usa II comando 
di caricamento dal programma WEDGE; poi 
batti RUN. Qualsiasi file sorgente che non sia 
slato precedentemente salvato viene perduto, 
giacché l'assembler viene allocato nella stes¬ 
sa zona di memoria da esso usata. 

BOOT ALL - Questo programma carica e lan¬ 
cia il DOS WEDGE, il caricatore HILOADER 
e l'EDITOR allo stesso tempo. Questi tre pro¬ 
grammi risiedono in aree di memoria diffe¬ 


renti, in modo da permettere il loro utilizzo con¬ 
temporaneo. 

CROSSREF64 - Questo programma serve a 
stampare il listato di riferimento incrociato crea¬ 
to dall'assembler con un'apposita opzione al 
momento della compilazione. Il programma vie¬ 
ne caricato nella parte bassa della memoria con 
ii comando LOAD "CROSSREF64', 8 e viene 
lanciato con il comando RUN. 

DOS 5.1. Questo file contiene il codice mac¬ 
china per il programma WEDGE. Esso viene 
caricato automaticamente lanciando il program¬ 
ma WEDGE stesso. 

DOS WEDGE64 - Vedi la sezione 5. Questo 
programma carica il DOS 5.1. È il primo pro¬ 
gramma su disco, cosi che può essere carica¬ 
lo con il comando LOAD 8. Dopo che il 
programma è sfato caricato, batti RUN. 

EDITOR64 - Vedi la sezione 6. Questo pro¬ 
gramma è usato per creare e modificare i file 
di codice sorgente che devono essere assem¬ 
blati. Per caricare l'editor, batti LOAD 
"EDITOR64",8,1. Dopo che il programma è 
stato caricato, batti SYS 49152 per lanciarlo. 
Poi batti NEW per azzerare i puntatori prima 
di creare o editare i file. Assicurati di salvare 
il codice sorgente usando il comando PUT pri¬ 
ma di caricare l'assembler. 

LOLOADER64 e HILOADER64 - Vedi la sezio¬ 
ne 8. Questi due programmi sono usati per ca¬ 
ricare i record sequenziali creati dall'assembler 
come codice oggetto. Quando uno di questi 
due programmi viene lanciato, esso carica il fi¬ 
le oggetto nelle locazioni di memoria specifica¬ 
te, e lo trasforma in codice macchina pronto per 
essere eseguito. La sola differenza tra i due 
programmi consiste nel fatto che LOLOADER 
risiede all'indirizzo esadecimale $0800. mentre 
HILOADER risiede a $C800. Essi sono enlram- 
bl forniti nel caso che uno di loro interferisse 
con la locazione in cui volete porre il codice og¬ 
getto. Per caricare la versione posta a $0800. 
batti LOAD "LOLOADER64", 8 seguito da 
RUN; per caricare l'altra, batti LOAD 
"HILOADER64", 8 seguito da SYS 51200. 

MONITOR $8000 e MONITOR SC00O - Vedi la 
sezione 9. Questi due monitor sono pressoché 
identici, e vengono usali principalmente per ca¬ 
ricare e salvare file binari di codice macchina 
in forma eseguibile. Essi permettono anche 


24 




all’utente dì esaminare e modificare i program¬ 
mi senza dovere ripetere tutto il processo di 
compilazione. Il primo viene caricato all’indirizzo 
esadecimale $8000 battendo LOAD "MONI- 
TOR$8000",8,1 e viene lanciato con SYS 
32768. Il secondo programma viene caricato al¬ 
l'indirizzo esadecimale SC000 battendo LOAD 
’’MONITORSCOOO",8,1 seguito da SYS 49152. 

APPENDICE V 

CODIFICHE DEI MICROPROCESSORI 
DELLA SERIE 6500 

ADC Add with Carry to Accumulator - somma 
con riporto all'accumulatore 
AND "AND" to accumulator - operazione lo¬ 
gica AND 

ASL Shift Left One Bit (Memory or Accumula¬ 
tor) -- sposta di un bit a sinistra (la memoria o 
l'accumulatore) 

BCC Brandi on Carry Clear - salta se il llag 
di riporto è uguale a zero 
BCS Brandi on Carry Set - salta se il flag di 
riporto è uguale a uno 
BEO Brandi on Zero Result- salta se il risul¬ 
tato è zero 

BIT Test Bit in Memory with Accumulator - con¬ 
trolla un bit di memoria con l'accumulatore 
BMI Branch on Result Minus - salta se il risul- 
-tato è negativo 

BNE Branch on Result not Zero - salta se il 
risultato è diverso da zero 
BPL Branch on Result Plus - salta se il risulta¬ 
to è positivo 

BRK Force an Interrupt or Break - forza un in- 
terrupt 

BVC Branch on Overflow Clear - saita se il flag 

di overflow è uguale a zero 

BVS Branch on Overflow Set - salta se il flag 

di overflow è uguale a uno 

CLC Clear Carry Flag - poni il flag di riporto 

uguale a zero 

CLD Clear Decimai Mode - esci dal modo de¬ 
cimale 

CLI Clear Interrupt Disable Bit - poni il bit che 
disabilita gli interrupt uguale a zero 
CLV Clear Overflow Flag - poni il flag di over¬ 
flow uguale a zero 

CMP Compare Memory and Accumulator - 
confronta la memoria con l'accumulatore 
CPX Compare Memory and Index X - confron¬ 
ta la memoria con l'indice X 
CPY Compare Memory and Index Y - confron¬ 
ta la memoria con l'indice Y 
DEC Decrement Memory by One - decremen- 
ta di uno la memoria 


DEX Decrement Index X by One - decremen- 
ta di uno l’indice X 

DEY Decrement Index Y by One - decremen- 
ta di uno l’indice Y 

EOR Exclusive-OR Memory with Accumula¬ 
tor - operazione logica di OR esclusivo 
INC Increment Memory by one - incrementa 
di uno la memoria 

INX Increment Index X by one - incrementa 
di uno l’indice X 

INY Increment Index Y by one - incrementa 
di uno l’indice Y 

JMP Jump to New Location - salto ad una 
nuova locazione 

JSR Jump To New Location Saving Return 
Address -- salta ad una nuova locazione sal¬ 
vando l’indirizzo di ritorno 
LDA Transfer Memory to Accumulator - co¬ 
pia la memoria all’accumulatore 
LDX Transfer Memory to Index X - copia la 
memoria all'indice X 

LDY Transfer Memory to Index Y -- copia la 
memoria all'indice Y 

LSR Shift One Bit Righi (Memory or Accumu¬ 
lator) -- sposta di un bit a destra (la memoria 
o l'accumulatore) 

NOP No Operation ~ Non fa niente 
ORA "OR" Memory with Accumulator -- ope¬ 
razione logica OR 

PHA Push Accumulator on Stack - metti l'ac¬ 
cumulatore nello stack 
PHP Push Processor Status on Stack - metti 
lo stato del processore nello stack 
PLA Pulì Accumulator from Stack - prendi 
l’accumulatore dallo stack 
PLP Pulì Processor Status from Stack - pren¬ 
di lo stato del processore dallo stack 
ROL Rotate One Bit Left (Memory Or Accu¬ 
mulator) - ruota di un bit a sinistra (la memo¬ 
ria o l’accumulatore) 

ROR Rotate One Bit Right (Memory or Accu¬ 
mulator) - ruota di un bit a destra (la memo¬ 
ria o l’accumulatore) 

RTI Return from Interrupt - ritorna da un in¬ 
terrupt 

RTS Return from Subruoutine - ritorna da una 
subroutine 

SBC Subtract Memory and Carry from Accu¬ 
mulator -- sottrai la memoria ed il riporto dal¬ 
l'accumulatore 

SEC Set Carry Flag - Poni il flag di riporto 
uguale a uno 

SED Set Decimai Mode - inserisci il modo de¬ 
cimale 

SEI Set Interrupt Disable State -- disabilita gli 
interrupt 
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STA Store Accumulator in Memory - immagaz¬ 
zina l’accumulatore in memoria 
STX Store Index X in Memory - immagazzina 
il registro X in memoria 
STY Store Index Y in Memory - immagazzina 
il registro Y in memoria 
TAX Transfer Accumulator to Index X - trasfe¬ 
risci l'accumulatore all'indice X 
TAY Transfer Accumulator to Index Y - Trasfe¬ 
risci l'accumulatore all'indice Y 
TSX Transfer Stack to Index X - trasferisci lo 
stack all'indice X 

TXA Transfer Index X to Accumulator ~ tra¬ 
sferisci l’indice X all'accumulatore 
TXS Transfer Index X to Stack Register - tra¬ 
sferisci l’indice X al registro dello stack 
TYA Transfer Index Y to Accumulator - trasfe¬ 
risci l'indice Y all'accumulatore 

APPENDICE VI 

SPIEGAZIONE DEI MESSAGGI DI ERRORE 

Nel listato dei programmi sono posti alcuni mes¬ 
saggi di errore che accompagnano i comandi 
errati. Quella che segue è una lista di tutti i mes¬ 
saggi di errore che possono essere prodotti du¬ 
rante la compilazione 

MODO NON PERMESSO 

Dopo la codifica corretta, separata da uno o più 
spazi, c'è la lettera A. L'assembler sta tentan¬ 
do di usare l'accumulatore come operando (A 
indica infatti il modo accumulatore), ma la co¬ 
difica in quel comando è una di quelle che non 
permettono di riferirsi all'accumulatore. Control¬ 
la di non aver battuto una linea con etichetta 
A (illegale), al quale quel comando si riferisce. 
Se stavi provando a riferirti all'accumulatore, 
controlla gli operandi validi per la codifica usata 

A.X,Y,S,P RISERVATI 

L'etichetta del comando è uno dei cinque no¬ 
mi riservati (A,X,Y,S e P). Essi hanno un signi¬ 
ficato speciale per l'assembler e per questo non 
possono essere usati come etichette. L'uso di 
uno di questi nomi fa si che venga stampato 
un messaggio di errore e che non venga ge¬ 
nerato alcun codice per il comando. L'etichet¬ 
ta non viene definita ed appare nella tabella dei 
simboli come una variabile indefinita. Riferimen¬ 
ti ad una di queste etichette in un qualsiasi pun¬ 
to del programma generano messaggi di errore 
come se l'etichetta non fosse stata affatto di¬ 
chiarata. 


SALTO FUORI LIMITE 

Tutte le istruzioni di salto (escluse JMP e JSR) 
vengono compilate in due byte di codice. Un 
byte è per la codifica, l’altro indica l'indirizzo 
a cui saltare. Quest’ultimo è considerato re¬ 
lativamente aH’indirizzo del primo byte dell'i¬ 
struzione successiva a quella di salto. Se il 
valore del byte è compreso tra 0 e 127. il sal¬ 
to è in avanti: se Invece il valore del byte è 
compreso tra 1 28 e 255, il salto è all’indietro. 
Per questo una di queste istruzioni può sal¬ 
tare solamente 127 byte avanti e 128 indietro 
rispetto all'Indirizzo dell'inizio dell'istruzione 
successiva. Salti al di fuori di questi limiti ven¬ 
gono segnalati con questo messaggio d'erro¬ 
re. Per correggere l'errore devi ristrutturare 
il programma. 

ESPRESSIONE INESATTA 

Calcolando un'espressione, l'assembler trova 
un carattere che non può interpretare come 
parte di un 'espressione valida. Questo può ac¬ 
cadere se il campo che segue la codifica con¬ 
tiene caratteri speciali illegali all'interno di 
un’espressione (le parentesi, ad es.). Control¬ 
la il campo dell'operando ed assicurati che in 
esso vi siano solamente caratteri validi. 


DOPPIA DEFINIZIONE 

Il primo campo di una riga non è una codifica 
ed è interpretato come un'etichetta. Se la li¬ 
nea corrente è la prima in cui quel simbolo 
compare come etichetta (o se è la prima in cui 
compare alla sinistra di un segno di uguale/, 
il simbolo stesso viene posto nella tabella dei 
simboli ed assunto come definito in quella 
linea. 

Al contrario, se il simbolo è già apparso come 
etichetta oppure alla sinistra di un segno di 
uguale, in una linea precedente alla linea cor¬ 
rente, l'assembler lo trova già definito nella ta¬ 
bella dei simboli. 

Poiché l'assembler non permette la ridefinzio- 
ne dei simboli, viene stampato questo messag¬ 
gio di errore. 

FILE EXIST 
(IL FILE ESISTE GIÀ) 

Questo messaggio di errore viene stampato 
quando su disco è già presente un file con lo 
stesso nome di quello che si è assegnato al 
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file oggetto. Si può ovviare a questa situazio¬ 
ne cancellando il vecchio file o sostituendo il 
disco. 

FILE NOT FOUND 
(FILE NON TROVATO) 

Questo messaggio viene stampato quando si 
presenta uno di questi tre problemi: 

non è stato trovato il file sorgente 
un comando. LIB specifica un file inesistente 
un comando. FIL specifica un file inesistente 

L’utente deve assicurarsi di non avere inseri¬ 
to nel drive il disco sbagliato e che il nome 
del file sia scritto correttamente. 

RIFERIMENTO INDIETRO 

L'espressione sulla destra di un segno di 
uguale contiene un simbolo che non é stato 
definito in precedenza. Una delie operazioni 
dell'essembler è la valutazione delle espres¬ 
sioni e delle etichette, e l'assegnamento di un 
valore o dfun indirizzo ad esse. L'assembler 
processa il file sorgente in modo sequenzia¬ 
le, e ciò significa che tutti i simboli incontrali 
vengono divisi in due classi: quelli già definiti 
e quelli che vengono trovati per la prima vol¬ 
ta, e conseguentemente non sono ancora sta¬ 
ti definiti. L'assembler assegna i valori definiti 
e costruisce una tabella di valori indefiniti. 
Quando viene scoperto un simbolo usato in 
precedenza, viene sostituito nella tabella. 
L'assembler poi processa tutti i comandi una 
seconda volta usando i valori correntementi 
definiti. 

Un'etichetta o un'espressione che usi un va¬ 
lore non ancora definito è considerata esse¬ 
re riferita più avanti al valore da definire. 

Per permettere di valutare correttamente le 
espressioni, questo assembler permette un li¬ 
vello di riferimento in avanti, cosicché il codi¬ 
ce seguente è permesso: 


tt di linea 

etichetta 

codifica 

operando 

100 

BNE 

NEW 


200 

NEW 

LDA 

# 5 

Questo invece non è permesso: 


* di linea 

etichetta 

codifica 

operando 

100 

BNE 

NEW 


200 

NEW 

INC 

NEXT+5 

300 

NEXT 

LDA 

# 5 


Questa limitazione però non dovrebbe crea¬ 
re troppi problemi nell'uso normale delle eti¬ 
chette: per risolvere il problema dell'esempio 
è infatti sufficiente fare cosi: 


# di linea 

etichetta 

codifica 

operando 

100 

BNE 

NEW 


200 

NEXT 

LDA 

# 5 

300 

NEW 

INC 

NEXT+ 5 


Questo errore può anche significare che il va¬ 
lore alla destra del segno di uguale non è af¬ 
fatto definito in nessuna parte del programma, 
nel qual caso la soluzione è uguale a quella 
per i valori indefiniti 

L’assembler non può processare più di un li¬ 
vello di riferimento in avanti. 

Tutte le espressioni con simboli alla destra del 
segno di uguale, per essere valutate corret¬ 
tamente, devono riferirsi esclusivamente a 
simboli già definiti nelle linee precedenti. 


TIPO OPER. 

ILLEGALE 

Dopo avere trovato una codifica con operan¬ 
do non implicito, l'assembler tratta il campo 
dell'operando (il campo immediatamente suc¬ 
cessivo alla codifica che non sia composto di 
soli spazi) e determina il tipo di operando usato 
(indicizzato, assoluto, etc.). Se il tipo di ope¬ 
rando trovato non è compatibile con la codifi¬ 
ca, viene stampato questo messaggio di 
errore. 

Controlla che tipo di operando sono permessi 
per la codifica in questione ed assicurati che 
il formato dell'operando sia corretto (vedi la se¬ 
zione 1.1 sui modi di indirizzamento). 

Se il campo di operando inizia con una paran- 
tesi, controllalo attentamente. Se è previsto 
che sia un operando indiretto, ricontrolla il for¬ 
mato corretto per i due tipi disponibili. Se il for¬ 
mato è sbagliato (manca la parentesi di 
chiusura o il registro indice), viene stampato 
questo messaggio di errore. In un operando 
indicizzato controlla anche che i registri in- 
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OPCODE 
NON VALIDO 

L'assembler cerca nella linea fino a trovare la 
prima stringa di caratteri diversi dagli spazi. Se 
la stringa non è una delle 56 codifiche valide, 
la considera un'etichetta, e la pone nella ta¬ 
bella dei simboli. Poi continua a cercare la 
stringa successiva. Se non ne trova nessuna, 
legge la linea successiva e la compilazione 
prosegue, se invece viene trovato un secon¬ 
do campo, viene considerato una codifica (poi¬ 
ché è permessa una sola etichetta per riga). 
Se questa stringa di caratteri non è una codi¬ 
fica valida, viene stampato questo messaggio 
di errore. 

Questo errore può verificarsi quando la codifi¬ 
ca è scritta male, nel qual caso l'assembler in¬ 
terpreta la codifica come etichetta (se non c'è 
altra etichetta). Esso prova poi a compilare il 
secondo campo come se fosse una codifica. 
Se esiste un altro campo, viene stampato que¬ 
sto errore. 

Ricerca una codifica scritta male o una linea 
con più di una etichetta. 


GLI INDICI SONO X O Y 

Dopo avere trovato una codifica valida, l’as- 
sembler cerca l'operando. In questo caso il pri¬ 
mo carattere nel campo dell'operando è una 
parentesi. L'assembler interpreta dunque il 
prossimo campo come un indirizzo indiretto, 
che, eccetto il comando JUMP, deve essere 
indicizzato mediante uno dei due registri indi¬ 
ce, X e Y. Nel caso in cui il carattere che l'as- 
sembler considera essere il registro indice sia 
diverso da X e da Y, viene stampato questo 
messaggio di errore. 

Se il campo di operando inizia con una paren¬ 
tesi, controllalo attentamente. 

Se è previsto che sia un operando indiretto, 
ricontrolla il formato corretto per i due tipi di¬ 
sponibili. 

Se il formato è sbagliato (manca la parentesi 
di chiusura o il registro indice), viene stampa¬ 
to questo messaggio di errore. In un operan¬ 
do indicizzato controlla anche che i registri 
indice non manchino o non siano sbagliati (for¬ 
mato: espressione, registro indice). 


INDIREI. 

FUORI LIMITE 

L'assembler riconosce un indirizzo indiretto 
dalle parentesi che lo circondano. Se il cam¬ 
po che segue la codifica è compreso tra pa¬ 
rentesi, l'assembler tenta di compilarlo come 
un indirizzo indiretto. Se il campo dell'operan¬ 
do è maggiore di 255 (necessita quindi due by¬ 
te per essere espresso), viene stampato 
questo messaggio di errore. 

Questo errore si verifica solo quando il cam¬ 
po dell’operando ha forma corretta (cioè quan¬ 
do un registro indice segue l'indirizzo) e il 
campo dell'indirizzo è fuori dalla pagina zero. 
Per correggerlo, il campo dell'indirizzo deve 
essere rilerito alla pagina zero (il byte alto im¬ 
plicito è 00). 

INDIRIZZO 

NON VALIDO 

Un indirizzo menzionato in un’istruzione o l'in¬ 
dirizzo di un comando dell'assembler ( BYTE, 
.DBYTE, .WORD) non è valido. Nel caso di 
un'istruzione, l'operando generato dall'assem- 
bler deve essere maggiore o uguale a zero e 
minore o uguale a SFFFF (lungo cioè due by¬ 
te). (Chiaramente si devono escludere gli in¬ 
dirizzi delle istruzioni di salto relativo, che 
devono essere compresi tra -128 e +127 by¬ 
te dall’istruzione successiva). Se l’operando 
genera più di due byte di codice, oppure se 
è minore di zero, viene stampato questo mes¬ 
saggio di errore. 

Per il comando BYTE, ogni operando è limi¬ 
tato ad un byte. Tutti i riferimenti di indirizzo 
devono essere maggiori o uguali a zero. 

La validità è controllata dopo che l'operando 
è stato calcolato. Controlla i valori dei simboli 
usati nel campo dell'operando (vedi tabella dei 
simboli). 


INIZIO LABEL CON A-Z 

Il primo campo che non sia composto di soli 
spazi non è una codifica valida. Per questo 
l'assembler prova ad interpretarlo come un’e¬ 
tichetta. ma il primo carattere non è alfabeti¬ 
co. Viene stampato questo messaggio di er¬ 
rore. 
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Cerca un comando composto dal solo campo 
dell'operando che inizia con un carattere spe¬ 
ciale. Cerca anche linee la cui etichetta sia 
scritta male. 

LABEL 

TROPPO LUNGA 

Tutti ì simboli sono limitati a sei caratteri di lun¬ 
ghezza. Mentre compila, l'assembler cerca 
uno dei caratteri separatori (di solito uno spa¬ 
zio) per individuare la fine di una stringa. Se 
è stato usato un carattere illegale come sepa¬ 
ratore. viene stampato il messaggio di errore, 
in quanto il falso carattere separatore fa si che 
la lunghezza della stringa ecceda i sei carat¬ 
teri. Cerca i caratteri diversi dallo spazio tra eti¬ 
chette e codifiche. Cerca anche linee di 
commento che inizino con una parola più lun¬ 
ga di sei caratteri e non preceduta da un pun¬ 
to e virgola. In questo caso l'assembler sta 
provando ad interpretare parte del commento 
come etichetta. 


NON -'ALFANUMERICO 

Le etichette sono composte da sei caratteri al¬ 
fanumerici. Il campo dell'etichetta deve esse¬ 
re separato dal campo della codifica da uno 
o più spazi. Se c'è un carattere speciale o un 
altro carattere fra l'etichetta e la codifica po¬ 
trebbe essere stampato questo messaggio di 
errore. 

Ognuna delle 56 codifiche valide è composta 
da tre caratteri alfabetici. Esse devono esse¬ 
re separate dal campo dell'operando (sempre 
che ce ne sia uno) da uno o più spazi. Se la 
codifica finisce con un carattere speciale (co¬ 
me una virgola), viene stampato questo mes¬ 
saggio di errore. 

Un'etichetta da sola o una codifica che non ab¬ 
bia bisogno di operando possono essere se¬ 
guite direttamente da un punto e virgola, per 
indicare che il resto della linea è un commen¬ 
to (l'uso di un punto e virgola sposta il com¬ 
mento al punto di tabulazione successivo). 


PC NEGATIVO - RESET 0 

Un programma assemblato è caricato nella 
RAM nell'Intervallo di indirizzi tra 0 e 64K 


(65535). Questi sono i limiti del computer. Per 
definire un indirizzo possono essere usati al 
massimo due byte. Poiché non esiste memo¬ 
ria negativa, il tentativo di riferirsi ad un indi¬ 
rizzo negativo causa questo errore, ed il 
contatore di programma (o il puntatore della 
locazione di memoria corrente) viene posto a 
zero. 

Quando questo accade, l'assembler continua 
ad assemblare il codice con il nuovo valore del 
contatore di programma. Questo può far si che 
più byte vengano assemblati nelle medesime 
locazioni. Per questo, stai mollo attento a man¬ 
tenere il contatore di programma nei limiti con¬ 
sentiti. 

CAMPO NON COMPLETO 

Questo messaggio di errore viene stampato 
quando l’assembler sta cercando un campo 
necessario ed incontra la fine della linea cor¬ 
rente prima di trovare il campo stesso. Biso¬ 
gna ricercare le condizioni seguenti: un campo 
di codifica valido senza il campo di operando 
sulla stessa riga: una codifica che si pensava 
potesse agire con operando implicito, e che in¬ 
vece necessita di un operando; una stringa 
ASCII a cui manca la virgoletta di chiusura (as¬ 
sicurati che tutte le virgolette comprese nella 
stringa siano raddoppiate: per ottenere una vir¬ 
goletta alla fine di una stringa ne devi inserire 
tre, per una in mezzo ne devi insenre due, per 
chiudere la stringa solamente una); una virgola 
alla fine del campo dell'operando indica che 
devono esserci altri operandi: se non ci sono 
altri operandi, l'assembler oltrepassa la (ine 
della linea e segnala l’errore. 

READ ERROR (ERRORE DI LETTURA) 

Queslo messaggio comunica un errore di let¬ 
tura da parte del disco. Per una descrizione 
degli errori e delle loro cause, guarda il ma¬ 
nuale del disk drive. 

DIRETTIVA INDEFINITA 

Tutti i comandi riservali all’assembler (.BYTE, 
.WORD, etc) cominciano con un punto. Se il 
primo carattere di un campo è un punto, l’as- 
sembler interpreta i caratteri successivi come 
uno di questi comandi. 

Se però la stringa di caratteri non è un co- 
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mando valido, viene stampalo questo messag¬ 
gio di errore. 

Cerca i comandi scritti male ed i punti all'ini¬ 
zio di campi che non contengono comandi 
(campo dell'etichetta, della codifica, dell’o¬ 
perando), 

SIMBOLO NON DEFINITO 

Questo errore è generato dal secondo passag¬ 
gio dell'assembler. Se nel primo passaggio 
l'assembler trova un simbolo nel campo degli 
operandi (il campo che segue la codifica o che 
si trova a destra di un segno di uguale) che 
non è ancora stato definito, l'assembler pone 
il simbolo nella tabella perché possa essere in¬ 
terpretato nella seconda passata. Se il simbo¬ 
lo è definito (ovvero se sta a sinistra di un 
segno di uguale o se è il primo campo in una 
linea), la prima passata determina il suo valo¬ 
re e lo inserisce nella tabella dei simboli. Per 
questo un simbolo in un campo di operando, 
trovato prima di essere stato definito, viene de¬ 
finito durante la seconda passata. In questo 
caso la compilazione può essere completata. 

Se invece la prima passata non trova il sim¬ 
bolo come etichetta o posto a sinistra di un se¬ 
gno di uguale, l'assembler non lo inserisce 
nella tabella dei simboli come un simbolo de¬ 
finito. Quando la seconda passata prova ad in¬ 
terpretare il campo dell'operando in cui si trova 
quel simbolo, non c'é un valore corrispondente 
al simbolo, ed il campo non può essere inter¬ 
pretato. Per questo motivo viene stampato 
questo messaggio di errore. 

Questo errore si verifica anche se uno dei no¬ 
mi riservati A,X,Y,S o P viene usato come eti¬ 
chetta e ricorre in qualche parte del 
programma. 

Nel comando che contiene il simbolo riserva¬ 
lo. l'assembler lo vede come un simbolo inde¬ 
finito. Per correggere questi errori controlla di 
non aver usato uno dei simboli riservati, di non 
aver scritto male delle etichette o di non aver¬ 
ne dimenticata qualcuna. 

Nota: Quando l'assembler trova un'espressio¬ 
ne (in un campo di operando o a destra di un 
segno di uguale), esso prova a calcolarne il va¬ 
lore. Se in essa ci sono simboli non ancora 


definiti l'assembler la segnala come un riferi¬ 
mento in avanti ed aspetta a calcolarla nella 
seconda passata. Se l'espressione si trova sul¬ 
la parte destra di un segno di uguale, il riferi¬ 
mento in avanti è un errore e viene segnalato 
come tale. Invece, se l'espressione è nel cam¬ 
po dell'operando di una codifica valida, la pri¬ 
ma passata riserverà due byte per il valore 
dell’espressione e la segnala come un riferi¬ 
mento in avanti. Quando la seconda passata 
riempe il valore dell’espressione ed il valore 
è lungo un solo byte, l’istruzione risulta di un 
byte più lunga del necessario. Questo è il mo¬ 
tivo per cui i riferimenti in avanti alla pagina 
zero sprecano un byte di memoria (quello in 
più che era stato riservato). Durante la prima 
passata l'assembler non sapeva quanto fos¬ 
se grande il valore, cosi ha riservato memoria 
per il valore più grande, lungo due byte. 


APPENDICE VII 
Sommario dei comandi 
dell'Editor 64 


Comando 
AUTO n. 1 

AUTO 

CHANGE/ 
st/s 2 /, n 1 -n 2 

CHANGE/ 
s 1 /s 2 / 

CPUT 
‘FILE” 


Descrizione 
Comincia la numerazione au¬ 
tomatica 
Pone fine alla num. auto¬ 
matica 

Cambia una stringa in un in¬ 
tervallo 

Cambia una stringa in tutto il 
file 


PUT compattato, gli spazi inu¬ 
tili vengono rimossi 
DELETE ni -n2 Cancella un intervallo di linee 


FIND/ 

Sl/,n1-n2 

FIND/sl/ 

FORMAT 

n 1 -n 2 

GET "FILE'', 

n1,n2,n3 

GET ' FILE'' 

KILL 

LIST 

NUMBER 

n1,n2,n3 

PUT "FILE”, 

n1,n2,n3,n4 


Cerca una stringa in un inter¬ 
vallo di linee 
Cerca una stringa in tutto il file 
Stampa formattala 

Carica il testo da un file su 
disco 

Forma semplificata di GET 
Disabilita l'editor 
Lista linee di testo 
Rinumera il testo 


Salva 

disco 


testo su un file su 
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PUT "FILE" 

Forma semplificata di PUT 


APPENDICE IX 




Sommario dei comandi 


APPENDICE Vili 


del Dos Wedge 64 


Sommario dei comandi 




del Monitor 

Comando 

Descrizione 



@ 

Stato corrente del disco 

A - 


@C(dr): nfile 

Copia un file 

ASSEMBLE 

Assembla una linea di codice 

([voi]) = vfile 


C - COMPARE Confronta due zone di memo- 

([voi]) 



ria e slampa tutti i byte che le 

@1 (dr) 

Inizializza un drive 


differenziano 

@N (dr): 

Formatta un disco 

D - DISAS- 

Disassemblea una linea di 

nomedisco. id 

SEMBLE 

codice del 6502 

@Q 

Esce dal programma 

F - FILL 

Riempe la memoria con il va- 


WEDGE64 


lore specificato 

@R(dr): nfile 

Cambia nome ad un file 

G - GO 

Lancia l'esecuzione all'ind. 

{[voi]) = vfile 



specificato 

([voi]) 


H - HUNT 

Cerca nella memoria le ricor- 

@S(dr): nfile 

Cancella un file 


renze di alcuni byte 

@UJ 

Resetta il DOS 

1 - INTERRO- 


@$(dr):(nfile) 

Legge la directory 

GATE 

Mostra i valori ASCII delle lo- 

C) ([voi]) 



cazioni di memoria desi- 

«n 

Tutti i comandi DOS andran- 


de rate 


no a n, ove n è compreso tra 

L-LOAD 

Carica un file da cassetta o 


8 e 15 inclusi. 


disco 

/nomeflle 

Carica un file (all'indirizzo del 

M - MEMORY 

Mostra i valori esadecimali 


BASIC) 


delle locazioni di memoria de- 

%nomefile 

Carica un file (al suo indiriz- 


siderate 


zo di caricamento) 

N - NEW 

Riloca i programmi in codice 

Tnomefile 

Carica un file (all’indirizzo 

LOCATOR 

macchina dopo che sono stali 


BASIC e lo lancia) 

'' 

spostati 

—nomeflle 

Salva un file 

R-REGfSTERS Mostra i registri della CPU 



S-SAVE 

Salva su disco o cassetta 


Nota bene: 

T-TRANSFER 

Sposta del codice da una zo- 


'voi' è qualsiasi carattere rac- 


na di memoria all'altra 


chiuso tra parenlesi quadre: 

X-EXIT 

Esce dal MON64 (bisogna re- 


'dr' deve essere 0 o 1 per i ri- 


sedare il BASIC) 


spettivi drives. 
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